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CYCLE 9 HELPFUL HINTS 



This paper describes helpfyl hints on how to yse Cycle 9 of I 
HOS/VE. It Is intsncled to suppfe^entf rather than to replace* I 
the standard HOS/VE docy^entati on. If yoy have any questions or 
suggestions^ please see Tom McGee or Bonnie SMierzfoin* Appendix 
D lists background documents and how to obtain than* 

To obtain additional copies of this document while running on 
SNIOI at Arden HlllSf please types 

S£S*INT1.LISTHIHTS C«<nu»ber of copies> 

To obtain a copy with revision bars against the Helpful Hints 
of the previous build* one can types 

SESflHTl.LISTHIHTS PEV8 C*<nu«ber of copies> 

The C parameter Is optional and defaults to one* 
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HOS/VE Cycle 9 Helpful Hints 

1*0 nUQR CHARACTERISTICS OF THIS SUIiO 



1 . i4iQE«£ai£l£I£EIiIiaS«l]£«IMII^iyiLi} 



o Cycle 6 and subsequent cycles of NOS/VE are built to run with 
a NOS 6»1 base system and the DSD displays and coiwfaands have 
changed considerably from the NOS 5*3 base system used with 
Cycle 5* (See also the next bullet.) This hints docu^ient has 
been updated to reflect these changes where they affect 
NQS/WE# for Instancef using the command MVEnnnn to bring up 
NOS/VE instead of cp.NVEnnnn. For asore Information on the NOS 
coflifflands see BJ Swierzbln's flsemo of July 23 titled 'NOS 6.1 
Notes'^ the NOS reference jnanuals listed In Appendix A* or the 
NOS R6 Soft*»are Release Bulletin. 

WARNING (1)5 NOS jots and subsystems may noM be brought 
down by entering STQP> jsn.# for exaiRPle* STOP^SIQ. nil I bring 
down BATCHIO. DO NOT> DO HOT* DO NOT enter STQP^NVE. 

MARHIHG <2)s SES R2€ must be used with NOS V2 systems* 

The formats of the validations and user Index files 
(usually naaied VAtlOLZ and VALINDZ) have changed between NOS 
Version 1 and NOS Version 2. The modset «hich was added to 
the NOS 5E55 system ( the base for Cycle 7) changing the nai^es 
of these files to NEyOUZ and NEWNDZ has ual been added to 5F40 
(the base for Cycle 9). This means that In order to run Cycle 
9 the site analyst raust make a copy of file NEWOUZ on file 
VALIDUZ and a copy of file file NEWNOZ on file VAIINDZ. Then 
when there Is no longer any need to run Cycle If NEWOUZ Bn<5 
NEWNDZ can be purged. 

o 9*1 runs with NOS 5F41 and 1 Series networks* which Is the 
same level of networks that Cycle 7 runs with* 9.2 and 
subsequent systems run with NOS 5G41 and 4 Series networks. 
The process for bringing up NAM and lAF has changed with the 
new level networks! see Section 4 for details. 

Substantial changes have been made to the OS procedure in 
Cycle 9. See Section 4 for details. 

o Backup files created in Cycle 7 by the NOS/VE 

BACKUP. PERHANENT. FILE utility will not be able to be used by 

the RESTORE.PERHANENT.FILE utility in Cycles 9 and 10. Also* 

backup files created Ir Cycle 9 will not be able to be used by 
the RESTORE^PERMANENT^FILE utility In Cycle 10. 
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o set Cosiwand List Changes 

Hanageaitnt of SCt ccfiwand lists has €tianged# particularly 
as It relates to asynchronoys tasks* The changes were isade 
primarily for performance and should have no impact on ^ost 
(all! users* The changes ares 

- An asynchronous task now has Its own '•job level" cofflnand 
list which is initialized to the "Job levei** command 
list of Its parent task. The asynchronous task pay 
alter its command list without affecting Its parent 
task* 

- The system supplied command library 
(osf $cowmand«l Ibrary) Is now searched as part of the 
Ssystem command list entry* 

- Support for the following '•old" command names has been 
r eiBovedi 

ACCEPT* CTf CEClARE^VARIABLEf DECVAR, DO, IHCIUDE* 
REH0VE.VARIA8LE and REHVAR 

- Certain commands which previously were always found at 
the front of the command list have been moved to a list 
which Is searched after all other command list entries 
have been searched* (This is to allow a user to supply 
his/her own version*) The affected commands are? 

ACCEPT. IIH£> ACCL# CREATE.VARIABIE, CREV* 
DELETE. VARIABLE* DELV* IMCF* INCLUOE.FILE, 
INCLf INCLUOE.LINE* SETCL and SET.COHMAND.L 1ST* 

- The convention for function names (that their first 
character foe a *»$•») has been made Into a rule (l*e. a 
name that does not begin with a *•$•• will not be 
recognized as a function name*) 

- The RROCedure "append.command.l isf* no longer exists* 
Its operation has been replaced by a new parameter on 
the set. command, list command* namely *»pl acement" or "p** 
with possible values of "after*'* "a"* ••before"* and "b"* 
with ••before" as the default* This parameter affects 
whether command list entries being added are placed 
before or after the current entries in the list* 

- The commands dociimented as being operator only commands 
are now actually available only to the operator* 

- The HCS commands are no longer supported* 
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- The full laode of the d ispl ay^cowwand^l 1st command has 
been upgraded so that the coptnar^ds of^ 
osf $cogipand_n br try are displayed as part of the $syste«? 
comi^and list entry* Also* the coinpands available on af> 
object library i^hich Is a cosiffland list entry are shown 
In the display* 

- The Sflle function now supports the cycl e^nuraber Ccn) 
option. 

QUICK.DEADSTART does net work In Cycle 9. Use of this cofisfnand 
Mill hang the system. 

o To access NQS/VE I nteract I vel y# the user must login to the 
application naiied VEIAF* For examplsJ #OAH# OAHX^VEIAF The 
previous application name v»as TAF* 

o With Cycle 7# the operator of the NOS/VE dual state system can 
simulate terwilnal breal^s. She/he way issue at any tipe a 
*8REAK at the K display for the NV£ job. This will start the 
terminal break* which iiorks just like the interactive break. 
The broken coiamand aiay be continued by issuing the 
resune.cowwand Cresc) or roay be terailnated by issuing the 
ter mi nate.coiRiBand <terc). If the comiBand get.file is broken 
into» the coiBiBand will be teraslnated by the Remote Host. 
After the DS proc has been executed* a terinlnal break at the 
comiRand level will cause the SCL task to terminate. The job 
monitor task will restart the SCL task after a brief delay Cup 
to 20 seconds). 

On 2 occasions* a procedure which (among other things) 
executed a TERMINATE^LOG crashed a Cycle 7 system. The PSR 
nuaiber for this problem Is not available yet and the guilty 
party hasn't been identified* but It Is suggested that the 
user treat TERMINATE.LCG with a healthy suspicion. 

o The user should not issue a pause or terminate break while 
DISPLAY.COMHAND.LIST Is executing; this will CRASH the 
systejfl. 

o Known Remote Host problemsi 

The user nasie put or the banner for a job routed fron? the 
170 is incorrect. This has been reported with PSR HV0D073 and 
will be fixed in Cycle 9. 

o Hiscellaneous SCL ChangesJ 

A RIHG paraiueter has been added to the TASK/TASKEND 
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1.0 NAJOR CHARACreRISTICS OF THIS 8UILD 



CQmm^n4m This parameter aiay be ysed to switch to a new ring 
of execution Mlthln the user's validated m inlpy«i_r Ing and 
noi Inal.r log* 

A $RING function has been added* It has no argya?ents and 
returns the current ring of execution. 

Cowwands from user jobs are no longer written to the system 
log by default. This function Is controlled fey the new 
operator coramands ACTIVATE^SYSTEH^IOGSINS and 

OEACTIVATE.SYSTEH.lOGGmG. 

The abbreviation for the SKIP^TAPE coiiisand has been 
corrected to SKIT from SKIPT. 

A nem internal Interface* CLPSVAIIOATE^MAME has been 

added. This is an INLINE procedure that should fee used 

Instead of the high ovtrhead CLPSCONVERT^STRING.TQ.NAHE . I See 
co«r»on deck CLXVN for Interface details.l 

DISPLAY^FILE leaves the source file with an attribute of 
RT*U« This can be corrected by setting the RT attribute back 
to the correct value after the DISPLAY values SETFA file RT-V 

o CQPY^FILE Mill not copy at £01 If It had been specified on the 
CQPF cofseand. The follo*#lng sequence will accoajpllsh copying 
at EQis 

SETFA dest.fi ie OP«$EOI 
CQPF source.fHe dest.fi le 
SETFA dest.fi le 0P«$80I 

o The permanent file system has been modified to isake files 
Invisible when all cycles have been purged even If one or «nore 
of those cycles are still attached. This results in 
references to the file emitting an unknown file message as 
expected* rather thar an unknown cycle message containing an 
Invalid cycle number. It also prevents display catalog 
coimnands from showing the file as having zero cycles. 

The administer utility has been updated to correspond to Rev. 
9 of the NOS/VE Commend Interface ERS. Old command and 
parameter names ^re no longer supported. 

o The TAFNVE operator command ITAF control pointi is no longer 
required or available* The capabilities that were provided by 
it have been packaged within the NVE subsystem control point. 
The Impact of this change is as follows: 
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- The K display is assigned to the same control point 
during both dsadstart and noraial systeis operation* 

- Oytput frota the system core debugger mIM no longer 
appear at the NV£ control point K-display. All system 
core debugger cofrmuni cat! on is via the MOO tersiinal. 

- The K»*8YEV£« ccainiand is no longer aval I able* 

- The 0FFS^^Jsn^6» cominand before doing a STOPfjsn* is 
not required to bring NVE down* 

- All capabilities are available via the NVExxxx. 
coiRmand. The NVE subsystem way be placed at any control 
point C 11 ke NAH is)« 

o Cycle 5 (actually Cycle 4) of NQS/VE no longer supports the 
••old" coffliiand names for system counnands* Both •'old*' and *»new»* 
names have been supported since Build Q* See DAP ARH4776 for 
details* As part of this change the abbreviations for the 
COPY^FILE and PRINT. FILE commands have been corrected to COPF 
and PRIF (froro COPYF and PRINTF). 

o The EXPLAIN command i^as liplewented In Cycle 4 of HOS/VE* 
Oon't get too excited about this* however* because as yet 
there are no "explain level** message templates for any of the 
system conditions* EXPLAIN mIII simply regurgitate the 
regular message* 

While ifliplementing the EXPLAIN command It was discovered that 
the specification of the command (i«e* that it have an 
optional "condl t Ion** parameter) ^as not nearly as useful as 
having the first parameter be a "status" value* So the 
implementation deviates from the ERS in that the first 
parameter to EXPLAIN Is MESSAGE.STATUS qt HS and Is of kind 
STATUS* The SSTATUS function can be used to transform a 
"condition" into a "status"* A DAP Is being written to make 
this change official* 

o NOS/VE multiple mass storage volumes have been Implemented in 
Cycle 5* For more Information see the section •Configuration 
Management** 

The Interstate Communication Facility* which Is described in 
Section 9 of the NOS/VE ERS - Program Interface (Rev* 8)* has 
been implemented* The callable subroutines described in 
section 9*3 reside In User Library LINKLI8 In the Integration 
catalogs INTl* OEVl* RELl* etc* NOS libraries SYSLI8 and 
SRVLIB are also required to complete the loading process* 
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LOSET loader coiBiitncJs must be used to select these liferaries* 
o Interactive Usage Restrictions! 

- When logging In to NOS/VE (Ue. H£ltO»VEIAF etc.) do not 
enter a terminate break <CTRL t) or a payse break (CTRL pH 
before the 'welcome message' appears at the terminal. A 
pause or terminate break entered before the Interactive 
NOS/VE Job has completed it's initialization niay crash the 
systeai* 

- A REQUEST^TERHINAl command in a batch job no longer crashes 
the systejB. 

o Any product or utility that Is placed In the iSYSTEH catalog 
Cor any frequently loaded prograrol should be bound using the 
CREATE^MODUIE subcoii»and of the CREATe^QBJECT.tlBR ARY 

utility. This mIII mlnlwlze overhead associated with loading 
the product or utility* 

Debug responds to terminal breaks when a prograis Is being 
debugged. However^ entering a pause or terminate break when 
debug Is active Ci.e. the DS/ prorapt has appeared and the 
user has not Issued the RUN cosipand) ^111 cause the task to 
terininate. 

o When sharing executable flies via permanent files Ci.e. 
compilers* libraries* etc.l you should iiake the file an 
object library via tr?e CREATE.OBJECT^LISRARY utility. By 
sharing object libraries Instead of object files* the code Is 
actually shared among all tasks using the library; the library 
Is not copied to another sega?ent but Is executed directly. 



l.I tiQ^£2£.ySA££.£XA!i£L£S 



1.1.1 EXECUTING PROGRAMS 



PROCESS 

Create an object text file by compiling a program on NOS. 
Then perform the followrng steps on NOS/VEs 

- Acquire any necessary libraries Cwhich are Qst quoted In text 
enib added directives) by either? 
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Attaching them froii! the systeis catalog* either explicitly 
or via prolog 

Of 

o Creatif^g t^e library file via the object library generator 

or 
o Staging the library file froat NOS to NOS/VE using the 
GET.08JECT_LI8RARY command* 

- Get the file from NOS find cof^vert the object text file frofii 
the CI data mapping to II data mapping by executing the 
CQNVERT.Q8JECT.FIiE cowand. 

- load and execute the program via the EXECUTE.TASK copnand* 
specifying the necessary libraries with the LIBRARY parajneterj 
alternatively SET.PROGRAH.ATTRIBUTES pay be used to include 
the libraries In all subsequent EXECUTE.TASK co?ii«ands» 

- Stage the loadmap frcw NOS/VE to NOS for printing by using 
either J 

The REPIACE.FILE coffwand with A6 conversion mo4e specified 
if running on the simulator* 

or 
o The PR INT. FILE command If running on the hardware. 

EXAMPLES 

The following is an example cofflmand sequence for executing a 
program not requiring any libraries for loading: 

Assumptions s ail modules to be loaded are contained on the NOS 
permanent file 'cltxtrs*. 

C0NVERT.08JECT.FILE CITXTRS 

EXECUTE.TASK CITXTRS PARAHETER*' program parameters' 

PRINT.FILE lOADMAP 

The following Is an example command sequence for executing a 
program requiring libraries for loading! 

Assumptionss the HOS permanent file *citxtrs* contains object 
text generated by the CY8IL CI compiler* The compiler modules 
reference procedures contained on the library •mylib' and the 
CYBIl run-time library. These libraries have been generated on 
NOS/VE and saved on NOS. 

GET.QBJECT.LIBRARY MYLI8 

SET.PROGRAM.ATTRIBUTES LO AD.MAP.OPT IONS' ( BLOCK, ENTRY.POI NT, SEGHENT 

Cycle 9, October 1982 



1-8 
NOS/VE Cycle 9 Helpful Hints 

l.O MAJOR CHARACTERISTICS OF THIS BUILD 
1*1*1 EXECUTING ^RQGRAHS 



CQMVERT.QBaeCT.FIlE CITXTRS 

eXECUTE.TASK CITXTRS ^progrmm parairieter s • LI8RARY«HYII8 

PRIMT.FItE iOAOMAP 



1*1.2 CREATE OBJECT LIBRARY ON NQS/VE AND SAVE IT OH NOS 



o CLG0170 Is NOS permanent file name for file contalr^lng CI 
object text for modules to be included In the library* 

o IITEXT180 is NOS/VE local file name for file containing II 
object text for modules to be included In the library* 

o LI8RARY180 Is NOS/VE Iccai file na^e for the library being 
created* 

o It 1 8170 is NOS permanent file name for file containing the 
I Ibrary* 

NOS/VE Job Co fflffli an ds 

COHVERT.OBJECT^FILE IITEXT180 CLGdl70 

CREATE.08JECT.LIBRARY 

ADO^HODULE L ISRARY'IITEXTISO 

GENERATE. LIBRARY LIBRARY* LIBRARY 180 

QUIT 

REPLACE.FILE LI8RARY180 ILI8170 DC=856 



1*1.3 MODIFY A PREVIOUSLY SAVED OBJECT LIBRARY 



o ILI8170 is NOS perflianert file name for file containing the old 
I Ibrary 

LI8RARY180 is NOS/VE local file natse for file containing the 
old I Ibrary 

o CHQD170 Is NOS per ma r^ent file naie for file containing CI 
object text for the new module 

o NEWIINOOULE Is NOS/VE local file najue for file containing II 
object text for the new module 
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1,1.3 MODIFY A PREVIQUStY SAVED OBJECT LIBRARY 



o HEMII8RARY Is NOS/VE local file naiBt for the Mbrary being 
created 

NLIB170 is NOS local f i Is naie for new library 

HOS/VE Job Cowhands 

SET^OBJECT.IISRARY LIBRARYie© IiIB170 

COMVERT.DBJECT^FILE NE^MMOOUIE CH00170 

CREATE.OSJECT^LIBRARY 

AOD.HQOUIE tI8RARY»LI8RARY180 

REPtACE.HOOULE LIBRARY«NE yilHODULE 

GENERATE.LIBRARY LIBRARYaNEMllBRARY 

QUIT 

RERtACE^EIlE NEytlBRARY MII8170 DC=856 

1.1*4 ROUTE AN INPUT FILE FROM NOS TO HOS/VE 

Running from an Interactive terfninal* enter: 

GET#f I lenawe. 

ROUTEffi lenaflie»OC-lP*FC*RH« 

The input file which Is sent to NOS/VE pust be In 6/12 ASCII 
<or display code subset)* The job file must be a single 
partition NOS record ccntainlng NOS/VE commands. The first 
statement must be a valid LOGIN command with user* password and 
faifilly nawe specif led. Hultl partition Input files are not 
supported by NOS/VE so NOS data files used by the program must be 
obtained through the GET_FIL£ command. 



1*1*5 PRINT A NOS/VE FILE 



At NOS/VE Job termination the Job log i^ill be automatically 
returned to NOS. The Job log mIII be appended to the NOS/VE 
output file OUTPUT. NOS/VE print files must be written by BAH as 
8/8 ASCII RT«V. Print files will be converted from 8/8 ASCII 
RT«V to NOS 8/12 ASCII when they are sent to NOS and will be 
printed In upper/lower case. 

Ail NOS/VE output files will appear In the NOS output queue 
CNOS Q*PR display) with tlie name NVExxxx as a banner. In order 
to print a NOS/VE file* the following command must be issued 
within your job or be entered from the system console via the 
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1.0 MAJOR CHARACTERISTICS OF THIS BUILD 
1.1.5 PRINT A NO$/V£ FILE 



operator fact I ityi 

PRIMT^FILE f llenaie 
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2.0 CONNAND INTERFACE STATUS 



2.0 IIQid4Mli-.IMI£E£M£.SIiiyS 



2.1 l££EiS-II].MOS£H£-iM-SiJlL«SIiI£ 



2.1.1 LOGIN TO HOS/VE 



To Initially login to NOS/VE via VEIAF* you must cause the 
first login attempt to fail. This can be done by responding to 
the •*FAHILYs*' login prompt with something likes "##*". This must 
be done because the systeni will try to connect the ter«ninal to 
lAF on the first loglr^ attei^pt no matter what is typed. To 
access VEIAF do the foflonlng on the second •*FAHILY2»« prompts 

* user* pas sword* VE I AF 

You can access VEIAF from lAF by doing "HELLOfVEIAF** or by 
answering VEIAF to the systesi prompt "APPLICATIONS". 

2.1.2 TERHINAL USAGE 



1) The slant (/) Is the prompt to enter a NQS/VE command* Any 
normal HOS/VE comma rd can now be entered (continuation 
lines are prompted with ../)* The full ASCII character 
set* lower or upper case and all special characters* can be 
used. 

2) A LOGOUT command will cause the HOS/VE Interactive Job to 
terminate. A new HOS/VE Interactive Job can then be 
started by responding to the 'APPLICATIONS* prompt with 
VEIAF. 

3) Terminal breaks <control-t and control-p) can be used to 
terminate a task or command and suspend a task and enter a 
new task to process SCL commands. Control~t causes s 
terminate break and control-p causes a pause break. 
Terminate break will terminate a command or the most 
recently executed task. A pause break will suspend 
execution and allow commands to be entered. yhen a 
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terminal Is In paus€ break state* two additional coi^iiands 
ar e aval I abl e: 

RESUHE^COHHANO - resume execution at the point of 
Interrupt Ion. 

TERfllNATE.COflMAND - cause a terminate break condition as 
a terminate break bad been entered* 

Botb terminate break ard pause break are available to progrants 
as conditions via the program inanageinent condition a?echanisip« 

2.1,3 NOS/VE PROGRAH ACCESS TO THE TERMINAt 

I) Interactive HQS/VE jobs are able to obtain terminal input 
through the AHP$6ET.NEXT or AMPSGET.PARTIAL program 
Interface Hhlch can be used by both task services and user 
ring programs. Interactive programs which use this 

Interface should be able to handle both upptr and lower 
case Input In order to make them more convenient to use In 
both 64 and 96 character set modes* 

During the next few months a comaiand supported by the system 
may not be In sync with your command interface document. The 
parameter descriptor table gives an accurate* concise description 
of the command interface as currently supported. 

The definition of a coirmand's parameter list Is enclosed In 
parenthesis with a parameter description per line. Each 
description has the general formJ 

PARAMETER NAMES AL10¥ED PARAMETER VALUES « PARAMETER DEFAULT 
VALUE 

Parameter Names - describes the parameter name and any 
abbrev iat ions. 

ALLOWED PARAMETER VALUES - describes the kind of value allowed 
and whether a list of values Is possible. The value kind can be 
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2.0 COHHANO INTERFACE STATUS 
2.2 COMHANO AND PARAMETER NAVIES 



further qualified. In 
described using the 
INTEGEI?# STRING* NAHE* 



soie cases* the 
KEY notation. 
FILE* STATUS. 



actual values allowed are 
The value kinds include 



PARAHETER DEFAULT VALUES - describes the defaulting rules 
and/or values for the parameter* fREOUIREO and SQFTIONAL are 
obvious. Other values In this position i«lil be treated as if 
they were entered by the yser on coffipand invocation. 



See the 
detai i s. 



PROC cofflfJiand in the Coiu^and Interface ERS for more 



The PDTs for the cofflmards currently In the system can be 
displayed using the DISPL AY.COHHANO.INFQRHATION copsiand. This is 
docufflented In the nonstandard coaispand section of this docuaient. 



2.3 couaiiii-EiiiiCiiaiii 



£MBfiiifiQ 

$HOD 

SCHAR 

$CLQCK 

$DATE 

$FIL£ 

SFNAHE 

SINTEGER 

SNAHE 

$ORD 

$REAL 

$STRING 

$STRLEN 

$STRREP 

$SU8STR 

SUNIQUE 

$TIHE 

$VAR 

SSPECIFIED 

SSET.COUNT 

$VALU£.COUNT 

$RANGE 

SPARAMETER^LIST 

SPARAHETER 

SSTATUS 

SCONDITIOM 

SSEVERITY 

SPROCESSQR 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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2.0 COffMAND INTStFACE STATUS 
2.3 COHHANO FUNCTIONS 



$4 08 

SPROGRAM 

$RING 



unchanged 
unchaf^gsd 
new 



3-^ iin£a«4£££iS-.£Q!Se4iOJ 



SET.LINK.ATTRIBUTES 

LOGIN 

LOGOUT 

SET.PASSWORD 



uncfianged 
unchanged 
unchanged 
unchanged 



- *1 



*1 The family name of the Job doing the subailt will be used as 
the default family name on batch jobs. The default for Jobs 
submitted from NOS will be family SSYSTEH. This affectively 
means that i^hensver NCS/VE jobs are submitted from NOS the 
family parameter Is required. 



Z * 5 E£SayEi;£.l!iy A5£fl£MI 



REQUEST.TERHINAL 



unchanged 



2.6 £ii£.i3MAfi£l!£liI 



SET.FItE^ATTRIBllTES 

COPr^FILE 

OISPLAY^FIIE 

COHPARE^FIIE 

01 SPIAY.FILE. ATTRIBUTES 

SKIP.TAPE 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



2 . 7 £££!! A!i£tiI-£IL£-tlMM£ mn. 
CAiQiaoil 

GET^FILE 
REPLACE.FILE 



unchanged 
unchanged 
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2.D COMMAND INTERFACe STATUS 
2*7 PERHANENT FILE HAHAGEMEHT 



CREATE.F 
ATTACH^? 
OELETE.F 
CHANGE.C 
CREATE.F 
OEIETE.F 
CREATE.C 
OELETE.C 
OEIETE^C 
CREATE.? 
OISPIAY^ 
OISPLAY. 
SET.MORK 



HE 

HE 

ILE 

ATALQG.ENTRY 

ILE.PERMIT 

ItE.PERHIT 

ATAIGG 

AT A LOG 

ATALOG.PERHIT 

ERHIT.CATALOG 

CATALOG 

CATALOG.ENTRY 

ING.CATALOG 



uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 



nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 

nged 
nged 
nged 
nged 



2. 8, Sili.5I4I£a£tiIS-4lii2-EEI^££0yE£l 

PRQC/PROCEND 

SET.COHMAND.LIST 

OISPLAY.COHHAND.LIST 

REPEAT/UNTIL 

yHILE/yHILEHO 

CREATE.VARIA8LE 

DELETE.VARIABLE 

8L0CK/8L0CKEN0 

LOQP/LQOPEND 

FQR/FOREHD 

IF/ELSEIF/ELSE/IFENO 

CYCLE 

EXIT 

yHEN/WHENEND 

CONTINUE 

CANCEL 

INCLUDE. FILE 

COLLECT.TEXT 

DISPLAY.VALUE 

EXIT.PROC 

ACCEPT.LINE 

INCLUDE. LINE 

CREATE.FILE.CQNNECTION 

DELETE.FILE.CONNECTIOK 

OISPLAY.FILE.CONNECTICH 

change HCS variable 

display HCS variable 



SiJiM^ 



uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 



nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
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a.O COHMAHO INTERFACE STATUS 
2,9 INTERACTIVE COHHAHDS 



2»9 IMI£EA£IlI£-£QBiM2S 

RESUHE^COHHANO unchanged 

TERHINATE^COHHANO unchanged 

SET^TERHINAL.ATTRIiUTES unchanged 

DISPLAY.TERHINAL^ATTRIBUTES unchanged 

esc-s new - 1* 

esc- I new - 1* 

ssc-j new - 1* 

esc-t new - I* 

esc-x new - 1* 

*1 These commands are entered with the 3-key sequence! 
escape^keyt character^ car r I age. return* The characters have 
the following meaningsJ 

e perforfs '*dlspl ay.job. status** coraaiand 

I perform "disp i ay^log 10*» command 

J perforji! **displ ey_job«status all** comfliand 

t discard all un process ed» typed- ahead input 

X terminate job# hut do not disconnect 



2.10 Ml££I-£OII£.!3AI!II£MAi££ 

CREATE«OBaECT«LIBRARY unchanged 

OISPLAY.N£«.lIBRARY unchanged 

SELECT.DISPLAY.OPTION unchanged 

ADD.HODULE unchanged 

REPLACE. HODULE unchanged 

COMBINE.HOOUIE unchanged 

CREATE.MODULE unchanged 

8IND.M00ULE unchanged 

CREATE.PROGRAH.DESCRIPTIOH unchanged 

OEIETE.MQOULE unchanged 

CHANGE.MOOULE.ATTRIBUTE unchanged 

SATISFY.EXTER^IAL.REFEREHCES unchanged 

REORDER. HODUIE unchanged 

GENERATE.IIBRARY unchanged 

OISPLAY.OBJECT.tlBRARY unchanged 

C0MPARE.Q8JECT.II8RARY unchanged 

QUIT unchanged 

CI to II Conversion unchanged 
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2.D COMMAND INTERFACE STATUS 
2,11 USER SERVICES 



2.11 yS£E.S£EMl££S 

OISPLAY^IOG 
DISPIAY.MESSAGE 



unchanged 
unchanged 



2.12 ElL£-EQyilli£ 
HCS JHROUTE 



r eaioved 



2.13 EEdaaM-ElECUIIQM 

SET.PRQGRAM^ATTRIBOTES 

OISPIAY.PROGRAH 

EXECUTE 

••name call" unchanged - *1 

TASK/TASKEND 

TERHINATE.TASK 

WAIT 

SET.0E8UG.RIHG 

OISPIAY.ACTIVE.TASKS 

*1 Warning - "name call" ^orks only for SCL procedures unless a 
SETFA cofliffland has been issued to specify that the 
FILE, CONTENTS are OBJECT and the F XLE..ORGANIZATION is DATA or 
LIBRARY. The SETFA ccmiiiand must fee reissued every time the 
file Is brought over froa? NOS. The CONYERT.OSJECT^FILEf 
G£T«OBJ£CT.FIlE» and GET^OBJ ECT. LIBRARY nonstandard commands 
Issue the appropriate SET.FILE.AT TRIBUTES coaiipand and arc 
therefore recommended. 



unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 


unchanged 



2.14 ii3a«l3MAS£f!!£!4I 

SUBMIT^JOB 

OISPLAY.JOB.STATUS 

TERiilNATE^JOB 

PRINT.FILE 

TERHINATE. PRINT 

OISPLAY.PRINT.STATUS 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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2.0 COHMANO INTERFACE STATUS 

2.15 MOIi«SI^MfiASIl-£QMMiOi 

The fol lolling coiumsnds provide a nonstandard means of 

perforffllng various frequertly performed functions. They may be 

superceded In subsequent builds by standard commands and 
capabl litres. 

2.15.1 OELETE.CATALOG.COHtEHTS J DELCC 

The purpose of this coirroand is to delete all entries frow the 
specified catalog. This Includes subcatalogs and the files ttiey 
contain. 

del ete^catal og.con tents C catal og»<cata log>] 

I status=<status var I ab ie>3 

catalogues This parameter specifies fron which catalog all 
files arc to be deleted. Osiission will cause 
the current working catalog to be used. 

status? See ERROR HANDLING. 

2.15.2 OISPLAY.ACTIVE.TASK J OISAT 

The purpose of this ccminand Is to display task statistics for 
all currently active tasks in a job. The foltoMing Information 
Is displayed. 

task name 

execution time ijse 
number of page faults 

display.acti ve^task Coutput«<f 1 1 e>l 

Cst at us«<s tatus variable>3 

output* 03 This paraireter specifies the file to which the 
task statistics Is displayed. Omission will 
cause SOUTPUT to be used. 
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Z*Q COHHAND INTERFACE STATUS 

2.15.3 OISPiAY.$YSTEH.OATA I OISSD 

The purpose of this commBr\4 Is to display system page fault 
statistics and system monitor request statistics. 

di spl ay.systefn^dat a Cdi sp lay.opt ion«page_f au I ts J pf 

•fflorltor.r equests! Bir Ja 1 1 
Cdisp lay.f or»iat«lnGf emental i I J total ' tl 
Coutput«<f 1 1 e>l 
Cstatus=<status vafiable>3 

displ ay^opt ionj do! This parameter specifies which 

statistics are to be displayed* The 
following options are allowed s 

fage.faults - display the page 

fault statistics. 

ffon I tor. re quests - display the systeip 

monitor request 
statist I cs. 

Cfnission $i i I I cause ALL to be 

used. 

d ispl ay^f ornsatl df 5 This paraiueter specifies whether a 

<ilsplay of the all statistics recorded 
so far Ctotal ) or only those statistics 
recorded since the last 

displ ay_syste»8.data coffl^sand 

(Increment a I) should be displayed. 
Omission will cause Incremental to be 
use49 

output*o: This parameter specifies the file to 

>«hlch the systerp data will be 

cispiayed. Omission will cause SQUTPUT 
to be used. 

statusi See ERROR HANDLING. 

2.15.4 DISPIAY.JOS.OATA J DISJD 

The purpose of this command Is to display the following job 
related statistics: 
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2,0 COWHAMD INTERFACE STATUS 
2*15.4 OISPIAY^JOS^DATA I DISJO 

tiwe in Job lode 

tlmt \n sionltof iiode 

coyfit of page In oparatlons 

reclaiajed p^^^s 

new pages assigned 

working set size 

count of ready tasks 

di spl ty.Job^data Cdlspl ay^optl on»job.data1 

Cdl spl ay_f ormat*! ncrefflantal * I J total 1 1 3 
i:output=<f n8>3 
£status»<status yariable>3 

d Ispl ay^opt Ion* dos This parapeter specifies which 

statistics are to be displayed. The 
following options ^tq alloiiedJ 

job^data - display job related data. 

Omission Villi cause job.data to be 
used. 

d Ispl ay_f or«ati df 5 This parajseter specifies whether a 

display of the all statistics recorded 
so far (total) or only those statistics 
recorded since the last d I spl ay.Job.d ata 
coinrsand llncreaientan should be 

displayed. Omission will cause 

incremental to be used. 

outputtoi This parameter specifies the file to 

lihich the job data will be displayed* 
emission will cause SQUTPOT to be used. 

status: See ERROR HANDLING. 

2.15.5 OISPLAY.CONMAND.IHFORHATION J DISCI 

The purpose of this cofrmand Is to display current Information 
about a NOS/VE command. The parameter naroest abbrevi at lons> 
allowed values and known problewjs for a conifaandj as supported In 
the current systeia* can be determined. This is a nonstandard 
command and will be replaced by the help utility sometime In the 
future. 

di spi ay^command^inf ormat I on command_name*<name>J al I 
CutI i I ty«name*create«obJect«l I brar y* 
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2*0 COMHANO INTERFACE STATUS 

ccllsource^code.yt 1 1 I tyl scui systeBi3 
Cdlspl ay.opt lon*paraweter_d€scf Ipt lon.tabl el 

pdt' no te s I naaie si he Ipl 
Coytput*<f i le r€f8rence>3 
Cstatys«<status varl ab le>1 

comsiand^natiie' en? This parameter specifies the name of the 

coPBiand about which Inforaiation is to be 
dl spl ayed* 

y ti I I ty^naraeiun: This parameter specifies which ytlilty the 

coirffland heiongs to* Omission wIM cause 
SYSTEM to be used. 

displ ay.opt ion* do J This parafneter specifies the type of 

display being requested. The options are: 

pararseter^descr ipt lon^table'pdt - selects 
a display of the paratueter descrip- 
tion table used by the com stand when 
executed* 

notes - selects a display of any known 
problems with the commanti* 

n a ires - selects a display of the command 
names for a ut i I Ity. 

help - selects a display of the copniand 
Interface description of the copmand. 

Omission will cause PDT to be used* 

outputioJ This parameter specifies the file to which 

information Mill be displayed* Omission 
will cause $OUTPUT to be used* 

status: See ERROR HANDLING. 

2*15.6 CONVERT^OBJECT.EIIE 5 CONQF 

The purpose of this command Is to get a NOS/VE object file 

produced on f^OS and to convert It to an object file suitable for 

processing by the NOS/VE loader or object code maintenance 
commands • 

convert«obJect_f I le to»<flle reference> 
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2.0 cmnkm interface status 

C u s e r «<n atB e> 3 
Cstatys'*<status var iab le>J 

tolt? This parameter specifies tlie NOS/VE file n^me on 
which the converted object file Is to be written* 

froaiSfs This parameter specifies the na«e of the NOS file to 
be converted* This is the permanent file naaie as 
defined In the NOS file system and can be up to seven 
characters In length. 

Oifilssion Mill cause the permanent file name of the 
TO paraaieter to be used. 

userlus This parameter specifies the HOS user identification 
of the owner of the file. This parameter is only 
neccessary If the file Is In a catalog other than the 
user who was specified by the most recently issued 
SET.LINK^ATTRIBUTES command. 

status J See ERROR HANOIING. 

2.15.7 GET.084ECT.FltE \ 6ET0F 

The purpose of this cofliwand Is to get a prevloysly converted 
HOS/VE object file from the NOS side and sets the appropriate 
file attributes that will allow the object file to be used by 
HOS/VE. 

get.object.fi I e to«<flle refer en C8> 

Cf row«<naffe>3 
Cuser*<naB!€>3 
tstatus«<status yariable>l 

to*t« This paranieter specifies the NOS/VE file naiise of the 
object file. 

from' f J This parameter specifies the NOS file name of the 

object file. This Is the permanent file name as 

defined in NOS and can be up to seven characters In 
length. 

Qffllsslon will cause the permanent file name of the 
TO parameter to be used. 

userlu: This parameter specifies the NOS user identification 
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10/26/82 

2,0 COMMAND INTEtFACE STATUS 

of the owner of the file* This parafieter is only 
necessary I f the file Is In a catalog other than the 
yser who was specified by the isost recently issued 
SET.IINK.ATTRIBUTES command. 

status? See ERROR HANDIIHG. 

2.15«8 GET.08JECT.LI8RARY J GETOL 

The purpose of this coaimtnd is to get a previously created 

NOS/VE object library fro« the NOS side and set the appropriate 

file attributes that will allow the object library to be used on 
NQS/VE. 

ge t^ob ject.l Ibrary to=<file refer€nce> 

Cf roif!«<naffle>3 
Cuser-<name>1 
Cstatu s«<status variable>3 

tOits This parameter specifies the NOS/VE file naise of the 
object I Ibrar y* 

froflj'fs This parameter specifies the NOS file name of the 
object file* This Is the permanent file najie bs 
defined in NOS and can be up to seven characters In 
length* 

Oralsslon will cause the periianent file name of the 
TO parameter to be used* 

userJuJ This parameter specifies the NOS user identification 
of the owner of the file* This parameter Is only 
necessary If the file is in a catalog other than the 
user who was specified on the most recently issued 
SET.LINK.ATTRIBUTES command* 

status: See ERROR HANCLING. 

2*15*9 DISPIAY.OBJECT.TEXT J DISOT 

The purpose of this cowmand is to produce a formatted display 
of the object text contained In an object file or object library 
produced on NOS/VE* 

dl sp I ay^object.text f 1 1 e=<f i le> 

Cycle 9* October 1982 



2-14 
HOS/VE Cycle 9 Helpful Hints 

2*Q CQnnmo interfacs status 

2»15*9 OISPtAY.OBaECT^TEXT I OISOT 

fm*»mmtmf-mmm mm »» ■*» m i» i» tm -mim m m *» *t mmm mm mtmmmm mm mm mmmmmmmmmm mmmmmmmmmmmmmm m mm m mm m 

Coutpyt=<fne referencOJ 
Cstatys=<statys variafoie>1 

fllelfs This piraffiet«r specifies the object file or object 
library containing the object text to be listed* 

out put* OS This parasieter specifies the file to which the 
display is to be writ ten* 

081 1 ss I on win cause the file SOUTPUT to be used. 

status s See ERROR HANDLING* 

2.15.10 GET^SOURCE.IISRARY J GETSL 

The purpose of this cofimand Is to get a previously created SCU 

source library from the HCS side and set the appropriate file 

attributes that will allow the source library to be used on 
NOS/y£. 

get^source^i Ibrary to«<flle reference> 

Cfroi!«<na»e>l 
Cuser-<na^e>1 
Cstatu s«<status var I abl e> 3 

tOiti This paraineter specifies the NOS/VE file name of the 
source I Ibrar y* 

froplfJ This parameter specifies the NOS file name of the 
source library* This Is the permanent file nape as 
defined In NOS and can be up to seven characters in 
I ength. 

Omission will cause the permanent file name of the 
TO parameter to be used* 

userlus This parameter specifies the HGS user Identification 
of the owner of the file* This parameter Is only 
necessary If the f 11 e Is In a catalog other than the 
user who was specified on the most recently Issued 
SET.LINK.ATTRIBUTES conifnand. 

status: See ERROR HANCIING. 
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2.9 COMMAND INTERFACE STATUS 

2*15.11 EDIT^FIIE ! EDIF 

The purpose of EDXT.FILE Is to Initiate the execytioo of the 
SCU editor o« i text file. (For details see ARH3883.I 

edIt.fHe I edif * edit lines on a source file. Cprocedure file 
not necessarily In Its firal form) 

UMLMM&t&tS, d&l^Ulkl 

fl le«f II e< source) SREQUIRED 

Cresult»f i t €Csource)3 $VALUg(FIlE) 

CInput'flle reference 3 ICQMMAHD 

toutput«frie referencel SOUTPUT 
[statu si 

2.15.12 JEOIT 



The purpose of this command Is to Initiate execution of the 
JEOIT editor built by Jack Sohnhoff. Anyone wanting infonnatlon 
about the editor should contact Jack* 

jedi t fro»!«<f i le> 

Cstatus»<status varlableM 

frofpJfJ This paraiaeter specifies the file to be edited. 
This file is rewritten after the editor 
terialnates. 

statuss See ERROR HANDLING In the N3S/VE Command 

Interface* 



2*15.13 DEBUG 



The prototype Rl NOS/VE debugger Is now available. Details on 
how to use the debugger can be found in the "CYBER 180 
INTERACTIVE DEBUG Exterral Reference Specification and User's 
Guide"* Sunnyvale DCS number S4028. 
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2.0 COMMAND INTERfACE STATUS 

2,15.X4 SET^LINK.ATTRISUTES I SETtA 

The SET«IIHK.ATTI?I8UTES coinaand Is the sarae as docupsentecl lo 
the NOS/VE command interfsce with the exception that the CHARGE 
and PROJECT ptraiiieters are optional (and in fact not useful In 
the current envlronwent since we disable that feature on the NOS 
si del* 
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3*0 PROGRAH IMTERFACE STATUS 



3,0 £ai]2EAi«I^II£££M£.SIiiyS 



The 'status' colui»n Indicates whether tt^e procedure is 
unchanged froro the prevloys builds modified fro?B the previous 
hulld or not available in this build* Footnotes are numbered 
within each section* 



3* 1 aQmitia-£aaa£aii!i£ 

CLP$SCAN.PARAM.IIST 

CLP$TEST«PARAHETER 

CLP$GET^KEY«ORD 

CLPSGET.SET.COONT 

CLPSGET^VALUE^COUHT 

CIPSTEST.RANGE 

CLPSGET.VAIUE 

ClPSCREATE.VARIABie 

CLPIDEiETE.VARIABLE 

CIPSREAD.VARIABIE 

CLPSiRITE.VARIABlE 

CLPSSCAN^CQMMANO^FILE 

CLPSENO.SCAN^COHWAHO^FIIE 

CtP$SCAN.COMHAND^tINE 

CLPSCREATE.FIIE^CQNNECTION 

CLPSOELETE^FILE.CONNECTIQH 

CiPSPUSH/POP.UTILITY 

CLPSGET.COM«ANO_QRIGI^^ 

CLPSGET.DATA.LINE 

CLP$SCAN.PROC.DECLARATIOH 



^iiiy;^ 



uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 



nged 
nged 
nged 
nged 
nged 
nged 
ngsd 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 



3*2 a£SSAia£-££M££AIQ£ 
£Liia£xiut£ 

QSPSFORMAT^HESSAGE 
QSP$SET.STATUS«ABNORM/M 
QSP$APPEH0.STATIJS.PAR4METER 
OSPSAPPEHD^STATUS.INTEGER 



unchanged 
unchanged 
unchanged 
unchanged 



Cycle 9p October 1982 



NQS/VE Cycle 9 Hsipful Hints 



3-2 
10/26/82 



3,D PROGRAH INTERFACE STATUS 
3.3 ReSOURCE MANAGEMENT 



3. 3 ££5ayEC£.BMlS£l2£MI 

RMPSREQUEST.MASS^STQRAGE 
RHPSREQUEST.TERHINAL 



unchanged 
unchanged 



Ail terminal attributes can fee specified on the 
RHPSREQUEST.TERMINAL call but only the following are operational: 

auto^input 
o transparent, mode 
o proflnpt^fiie 
prompt. str ing 



Files assigned to a tersi^inal 
following BAH requests? 

o ANPSOPEN 

AHPSGET^NEXT 

AHPSGET^DIRECT 

o AHPSGET.PARTIAL 

AHPSPUT^NEXT 

o AHP$PUT,OIRECT 

AHPSPUT.PARTIAl 

AMP$CLOSE 

AHP$REWIHO 

o AHP$SKIP 

AMPSSEEK^DIRECT 



device can be accessed via the 



3.^ ESmE^fi-OECyilOM 

PHPSEXIT 

PHPS EXECUTE 

PMPSTERMINATE 

PHPSAWAIT^TASK^TERMIN/STION 

PMPSMODULE^TABLE.ADDRESS 

PMPIENTRY^POINT.TASl EVADOR ESS 

PMP$PUSH_TA$K.DE BUG. MODE 

PMP$S£T.TASK«0E8UG.M0D£ 

PMPSTASK.DEBUG.HODE.ON 

PMP$SET.0E8UG,RING 

PMPSDE8UG.RIHG 

PHP$CHANG£.0E8UG.LI8RARY.LIST 

PMPSPOP.TASK.OEBUG.HOCE 



SlAiys 



uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 



nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
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3,0 PROGRAM INTERFACE STATUS 
3,5 PROGRAM CQHHUNICATIOH 



3.5 £gOiEAI.£QlliM!iI£lIIQi 



llMtUS. 



OSPSAMAIT^ACTIVITY.COnPlETION 


unchanged 


PHPSOEFIHE.QUEUE 


unchanged 


PMP$REHOVE«QU£U£ 


unchanged 


PMPSCQHNECT^QUEUE 


unchanged 


PH PSOISCONNECT.QUEUE 


unchanged 


PHPSSEMO.TO.QUEUE 


unchanged 


PNPSRECEIVE^FRO^.QUEUE 


unchanged 


PMPSSTATUS.QUEUE 


unchanged 


PHPSSTATUS^QUEUES^OEF INED 


unchanged 


PMPSGET.QUEUE^LIHITS 


unchanged 



3.6 aQMaiIiQi-£EQa£S5lIiS 

iLSiSi&ilUtS. 

PMPSESTABIISH.CONDITICN.HANDIER 

PHP$ DISESTA8LISH.C0HD.HAN0LER 

PHPSCAUSE^CONOITION 

PMPSCONTINUE.TO^CAUSE 

PMPSTEST.CQNOITION.HAt^OLER 

PMPSVAIIDATE.PREVIOUS.SAVE.AREA 

PMP$ESTA8LISH^DE8UG.0FF 

OSPSSET^STATUS.FROH.CDNDITION 



Added support of detected 

uncorrected error 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 

unchanged 



3.7 EgOfiSAB-SESMiaia 

PMPSGENERATE^UNIQUE.NAME 

PMPSGET^TIME 

PMP$GET.MICROSECQND.C lOCK 

PMPSGET.TASK^CP^TIME 

PMPSGET^DATE 

PHP$GET.USER.I0£NTIFICATON 

PMP$GET.ACCOUNT.PROJECT 

PMPSGET^JQB.NAMES 

PMP$GET.J08.I0 

PMP$GET_J0B.M00£ 

PMPSGET^PROGRAM 

PMPSGET.TASK.IO 

PMP$MAHAGE.S£NS£«SW ITCHES 

PMP$GET_OS«VERSI0N 



StJity^ 



uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 
uncha 



nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
nged 
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3.0 PROGRAM INTERFACE STATUS 
3,7 PROGRAH SERVICES 



PMPSGET.PROCESSOR^ATTRIBUTES 

PHP$DEEINE.0E8UG^ENTRY 

PHP$G£T«P£8UG.ENTRY 

PNPSMQDIFY.OESUG.ENTRY 

PMPSREHOVE.0E8UG.ENTRY 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 



3«a LDMIiii 

PHPSLOG 
PMPSLQG.ASCII 



unchanged 
unchanged 



3.9 £iL£^iMM£ll£iI 

Sequential Access 

Byte.Addressable Access 

Record Access 

Segflfsent Access 

V-Systera Speci f I ed 

V«.User Specified 

U^Systeis Specified 

U.User Specified 

F.System Specified 

F^User Specified 

AHPSOESCRIBE^NEM.FIIE 

AHP$FIte 

AMPSGET.FILE.ATTRIBUT ES 

AHPSFETCH 

AMPSSTORE 

AMPSCOPY.FIIE 

AHPSRENAME 

AMPSRETURN^FILE 

AHP$OPEN 

AHPSCIOSE 

AMPSFETCH.ACCESS^INFORflATION 

AHPSSKIP 

AH P$ REMIND 

AHP$«RITE.END.PARTITICH 

AHPIGET^NEXT 

AMPSGET.DIRECT 

AMPSGET^PARTIAL 

AMP$PUT.NEXT 

AMPSPUT.DIRECT 

AMP$PUT«PARTIAl 



SlLliUl 



unchanged 




unchanged 




unchanged 




unchanged - 


*1 


unchanged 




unchanged 




unchanged 




unchanged 




unchanged 




unchanged 




del eted 




unchanged 




unchanged 




unchanged 




unchanged 




unchanged 




unchanged 




new name 




unchanged 




unchanged 




unchanged 




unchanged 




♦ 2 




unchanged 




unchanged 




unchanged 




unchanged 




unchanged 




unchanged 




unchanged - 


t3 
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3*0 pmmAn ihtep.fac£ status 

3.9 FILE BAN AGE HE NT 



AMP$SEEK_OIRECT ynctianged 

AHPSSET^SEGHENT^PQINTER unchanged 

AHPSSET.SEGMENT.EOI unchanged 

AHPISET.SEGMENT. POSIT ION unchanged 

AHPISET^IOCAL.NAME^ABNORHAL unchanged 

AMPSSET.FILE.INSTANCE^ABHORMAl unchanged 

AMPSACCESS.METHOO unchanged 

AWP$FETCH.FAP^POINTER unchanged 

AHPSSTORE^FAP.POINTER unchanged 

Segment access If a segnient access file is written and an 
AMP$S£T.SESHENT^£OI is not Issued to record theEOI, EOI 
reialns zero* The higliest page referenced Is not yet used as 
the default EOI* This particularly affects those who uish to 
jjiake heaps permanent because £01 is always zero for a heap* 



*1 



*2 



AHPSREMIND 
supported* 



The WAIT paraiieter on the procedure call Is not 



*3 AHPSPUT^PARTIAl PUT^PARTIAl with the TERH.OPTION 

A!iC$T£RHINATE does Qflt act as a put. next If a preceding START 
Mas not Issued* 



3.10 £Ig|14i£MI«£lLi«!iiMAi5ii£MI 

PFPIOEFINE 

PFPSATTACH 

PFP$PURGE 

PFPSCHAHGE 

PFPSPERMIT 

PFP$DEIETE«PERNIT 

PFP$OEFIN£.CATALOG 

PFP$PURGE.CATA106 

PF PSPERHIT.CATAIOG 

PFPSDELETE.CATAIQG.PERHIT 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
undianged 
unchanged 
unchanged 
unchanged 



3.11 ti£!lQEI-.MM4fi£tlEliI 

liMPSAOVISE^IN 

MMPSADVISE.OUT 

MHPIAOVISE.OUT.IN 

MHP$ WRIT E.HOOIFIED.P AGES 

HMPSCREATE.SEGHENT 

MHPSOEIETE.SEGMENT 

MHPSSTORE.SEGHEHT.ATTRIBUTES 

HHPSFETCH.SEGflENT.ATTRIBUTES 



unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
unchanged 
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3«0 PROGRAH INTERFACg STATUS 
3»11 MEHORY HANASEMEHT 



HHPIVERIFY^ACCESS unchanged 

NHPIFREE unchanged 

MHPSLQCK. PAGES number of locked pages per 

MHP$UNiaCK_PAGES segment restricted to 32 

HHP$FETCH_PVA.UN«RITTEN.PAG£S unchanged 

3.12 lI4IiSIl£S-£4£iLiI]t 

SFPSESTABIISH.STATISTIC unchanged 

SFP$ENABtE_$TATISTIC unchanged 

SF P$OISABLE.STATISTIC unchanged 

SFPSDISESTABLISH.STATISTIC unchanged 

SFPSEHIT^STATISTIC unchanged 

SFPSEMIT^SYSTEM.STATI STIC unchanged 

3.13 IM£SllIIiM£.£4C:iLiII 

IFPSTERHINAl unchanged 

IFPSFETCH.TERMINAL unchanged 

IFPSSTORE.TERHIMAL unchanged 

IFP$GET,0EFLT.TERI!INAi_ATTRI8UTES unchanged 

IFPSGET.TERHINAL. ATTRIBUTES unchanged 

IFP$AOVAHCE new - *1 

*1 Only the option IFCSAD VANCE.All.QyEUED.OllTPUT is supported, 

3.14 Iii3S£^£-£lC££IIQMS 

The following sumwarizes the exception code ranges currently 
assigned to NOS/VE. These code ranges represent a finer 
breakdown than the one specified In the SIS for Internal NOS/VE 
development purposes. HcuevBrf It is important to remember that 
only the product Identifiers documented In the SIS may appear in 
error messages. 

Common fiodules 9#000 - 9^999 

Common Code Generator 8*000 - 8*999 
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3.0 PROGRAM INTERFACE STATUS 


*»m<m MM Mtm M MMIM M M 




3.14 HOS/VE EXCEPTIONS 






.M^ -JW ^0 .Wf Af -JW ^C 4V J^ ^^-40 00 1^ iW^ -I' 00 ^0 ^** ** ^* '^^ ^* ** "^ '*" "^^ ■** "** "'^^ '*' 




Product 




Exception 


Code 


I dent 1 f ler 


Product NasRe 


1 - 158 


*999 


Reserved 




159#000 - 


159*999 


SY 


System Core 


160»000 - 


169*999 


AH 


Basic Access He t hods 


160*000 


- 163*999 


8A 


Basic Access 


164*000 


- 164*999 


LN 


local Na^e Hgr 


165f000 


- 165*999 


JF 


Job File Hgr 


166>000 


- 166*999 


SR 


Conversion Services 


17 0*000 - 


179*999 


CL 


Command Language 


18 0*000 - 


189*999 


an 


Job Management 


190f000 - 


199*999 


11 


loader 


200#000 - 


209*999 


HH 


NeiBory Hanagement 


200*000 


- 204*999 


HM 


Hon i tor level 


205*000 


- 205*999 


^^ 


Task level 


210*000 - 


219*999 


OS 


Operating System 


210*000 


- 210*999 


OS 


OS 


211*000 


- 211*999 


HT 


EXEC 


212*000 


- 212*999 


10 


HS I/O 


213*000 


- 213*999 


10 


Tape I/O 


214*000 


- 214*999 


DH 


Device Hanagement 


215*000 


- 215*999 


HI 


Heraory link 


216*000 


- 216*999 


IF 


Interactive 


217*000 


- 217*999 


TH 


TH Monitor 


218*000 


- 218*999 


TH 


Tn Task 


219*000 


- 219*999 


JS 


Job Swappers 


220*000 - 


229*999 


PF 


Perwanent File 
Hanagement 


221*000 


- 221*999 


ST 


Set Management 


222*000 


- 222*999 


PU 


Permanent File Utilities 


23 0*000 - 


239*999 


PM 


Program Management 


24 0*000 - 


249*999 


RH 


Resource Management 


25 0*000 - 


259*999 


OF 


Operator Fad 1 1 ty 


260*000 - 


269*999 


AV 


User Administrator 


270*000 - 


279*999 


IC 


Interstate Communication 


280*000 - 


289*999 


RH 


Remote Host FacI 1 Ity 


290*000 - 


299*999 


DC 


Object Code UtI 1 1 ties 


300*000 - 


309*999 


OS 


Deadstart/Recover y 


310*000 - 


319*999 


MS 


Maintenance Services 


320*000 - 


329*999 


IF 


Interactive Facility 


330*000 - 


339*999 


US 


User Errors 


340*000 - 


349*999 


SF 


Statistics Fac. 


350*000 « 


359*999 


CM 


Configuration Management 


360*000 - 


369*999 


HU 


Help UtII Ities 


370*000 - 


379*999 


NA 


Network Access Method 


500*000 - 


509*999 


AA 


Advanced Access Method 


510*000 - 


519*999 


AG 


AlGOl 


520»000 - 


529*999 


AL 


Assembly language 
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3.0 f>ROSRAM INTEtFACE STATUS 






2:iL!322£5£L!i£i?n2!!5^ ^^. 






530*000 




539*999 


AP 


API 


540*000 


- 


549,999 


BA 


BASIC 




-. 


559*999 


CA 


Conversion Aids Systea 


560»000 


- 


569*999 


C8 


COBOL 


570*000 


- 


579*999 


CY 


CYBIl 


580*000 


- 


589*999 


FT 


FORTRAN 


59 0*000 


- 


599*999 


PA 


PASCAL Cyirth) 


600*000 


« 


609*999 


PI 


PL/1 




- 


619*999 


SH 


Sort Merge 


620*000 


« 


629*999 


sc 


Source Code Uti 1 i ty 


640*000 


- 


649*999 


08 


Detsug 
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4,0 DUAL STATE DEADSTART AHD OPERATION 



^* ayAL-.SIAI£-B£i0SI4EI-.ill0-.Q£££4Ii0i 



4. 1 cyM£i!i«syikL.ii4i£-s:i2iifi£yiiiioi 

The Afden HI! Is S2 dev elopineo t lab contains 12 FHO units# 
FHD Unit 43 <Ch. 1# 21, 22) 

This unit contains fiQS perroanent files. 

o FHD Unit 41 CCh. 1, 21, 22) 

This unit contains the folloi«ing! 

- Files required to deadstart dual state Cycle 5; A170 NOS 
(5.3 plus changes necessary for Cycle 5), CTI* »1SL, EI 
binarlesf and NOS Deads tart files* 

- It is also used as a tenip device* 

o FHD Unit 42 CCh. I, 21> 22) 

This unit contains NOS permanent files* 

o fno Unit 44 (Ch. 1) 

This is another NOS PF device* 

o FHD Unit 45 (Ch* 1) 

This unit contains files required to deadstart dual state 
Cycle 7; NOS 5E55 deadstart file, CTI143PR, HS1143PR, and EI. 
It Is also a HOS temp device. 

The foiioHina devices are available for hands-on use: channel 
If Zip 225 unit 401 channel 2, 22, 31s units 44 and 45| channel 
2? units 40, 41, 42, and 43* 
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4,0 DUAt STATE OEAOSTAtT AHD OI^ERATION 
4.2 USER NAWES AND PERMANENT FIIES 



4.2 yS£E-!IM£l--4MS«££Ei4^filI-.£IL£S 

1) The convention ysed for creating user naaias on NQS/VE Is as 

fOi I QMS 3 

Your user name will be your initials. 

o Your password mI 11 be these 3 letters followed fey the 

letter 'x* • 
You pust see CQHSCURCE CR.K. Cooper - x3092l to be 

assigned a user Index 

2) PF duiaping an4 loading 

You Bjay use **S£S. CUMPPF** on SH/101 to dump your perroanent 
flies to tape* and ther load theai onto your user name on A170 
NQS using **S£$«LOAOPF** • Oocupentat ion on how to use these SES 
procedures and nhat their parameters are Is Included in the 
SES User's Gulden or they can be obtained by typings 

SES^HELP.OUMPPF and SESf HEIP.IOAOPF. 

The basic reference for this section Is the NOS V2 Systeis 
Halntenance Hanual (60459300)# Section 5. The best specific 
reference Is Example 13 on page 5-37 In that manual. 

Using NOS 5.3* the analyst should 4o the followings 

X.DIS. 

SUI#377777. 

PURGECSQURCE/NA) 

DEFINE (SOURCE) 

HODVAL(QP«S#S«SOURCE#FA) 

DROP. 



Next* the file SOURCE should be XEOITed with the following 
dl rect IvesJ 

D/AB...*/* 

0/NF...*/* 

D/OF.. .»/* 

C/STANDARD/NORHAl/* 

C/CMLI/CNVE/* 
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4,D DUAL STATE DEAOSTART AND OPERATION 

4«3 CONVERTING VERSION 1 VALIDATION FILES TO VERSION 2 



Finally* after bringlnf up a NOS V2 systeaif do the followlngs 
(Notes An idle fasslly situation mast SKlst when the ISF con^nands 
are ai van. J 

X.OIS. 

SUI#377777. 

f>UR6Ef NEWOUZ>NEWNOZ. 

0£FINE#N£MOyZ*NEMNOZ* 

ATTACH, SOURCE, 

MQDVALIOP*C,I«SOURCE#SI*H«NEWDUZ»U»N£WNOZ) 

RETURN (N£yOUZ#N£MNDZ) 

I$FfR«NEllOUZ* (win release NEMDUZ If it Is fast-attach) 

ISF*E«N£yDUZ. 

DROP. 



4, 4 ia-E£LQ^i-£QiIEQLM4E£.£OE.ia£-MI2S£^£»aiSE-.llSIM£E 

At deadstart tl?ne NOS «m autowat Ically load 7155-lx disk 
controlware on one channel with controller type=FH (LBC CHRdeck 
entry) J and will automatically load 7155-4x disk control ware on 
any channel with controller type=HT (LBC CHRdeck entry). NOS/VE 
supports both of those types of controllers. NOTES It Is not 
possible to use 844 half-track control ware in this environment. 

<^.5 4I2a«IiQS-0£AfiSIA£I 



4,5.1 CTI AND CHECKING CENTRAL MEMORY 



Deadstart Ing A170 NOS assumes soiT!e knowledge of CTI. CTI 
stands for Cofnmon Test and Initialization. It is software that 
places an 8 00 series inacMne in a state such that it is possible 
to deadstart an operating system. CTI is used somewhat 
ambiguously in the software cofmnunl ty to Imply CTI and MSL 
(Maintenance Software Library). The MSL is a collection of 
programs and data that Includes such things as a subset of CMSE 
(Cyber Haintenance Software Executive) that enables one to load 
controlware to control lers# look at CYBER 180 maintenance 
registers, look at microcodef etc. The MSL also contains 
microcode that can be loaded by CTI. The HSL is actually an 
operating system that runs independently of NOS. An Important 
element of CTI/!iSL is HIVS (Hardware Verification Sequence), 
which Is a program that loads microcode, clears and checks 
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4.0 DUAL STATE DEADSTAf?T AND OPERATION 
4. 5,1 CTI AND CHECKING CEHTtAl MEHORY 



imiM mnt M 



central memory and tests «ll 170 opcodes. If you are not sure 
wNat the machine was used for (particularly the first hands on 
user each «ornlng> then t^e HIVS prograsi should be run. This Is 
acco!sp I i shed foys 

X) deadstart to NOS/VE CunIt 40 for S3f unit 45 for S2) 

2) Enter (operator Intervention) 

3) Enter P Cdeadstart panel^wake sure level deadstart) 

4) <8K$P> 

5) Enter H (assure yourself that CS«YES to reload microcode) 
61 <8KSP> 

7) Enter V (verification secjuence) 

8) Hit <CR> at 'parameter display* to test CM S CP 

When you see text that tells you that verification Is complete 
and a deadstart Is required^ you are now ready to deadstart NOS. 

4.5.2 NOS DEADSTART 



See Section 3.3 of the Integration Procedures Notebook for 
important NOS CMROECK charges, 
o Set the D/S panel to deadstart from the pr liuary system disk. 

This is 844 pack P0345 for 9.1 and 844 pack P0367 for 9.2 and 

subsequent syste?«s. 
o Push 0/S button 
o Enter (CR) 
o Enter date/time 

yalt for deadstart to complete. 

Notes The deadstart tapes DU91A and 0U92A for 9.1 and 9.2 
respectively are found in the area in the northeast corner of the 
S2 lab where the tape cabinet Is found. 



4 
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4.D DUAL STATE OEADSTART AND OPERATION 
4«6 NOS/VE OEADSTART AND INSTALLATION 



4* 6 MQS^E£«Q£4MIAai-^llfi.iMSI4LLMiOM 

o Enter 00IIN^CH2» so NOS/VE can use the channel • 

o Enter D0WN>CH32« so HCS/VE can use the channel* 

o The following file fliyst be available In your catalog on the 
S2 • 

TPXXXK contains a HOS/VE deadstart Iraage. This ipust be a copy of 
the dual state deads tart Images available fron the link 
procedures* 

o If you've never deadstsrted NOS/VE frooj the user nuiber froii 
which you want to run or If you wish to change the current 
parameter settings for your particular user nu?nber* then do a 
SETVE* SiTVE assumes the file TPXXXK is in your user number; 
you do not have to do another SETVE If TPXXXK has changed 
since the last time you ran* The general for in of SETVE Is? 

X. SETVE tPN«ffff>yN«un»C=6l 

where ffff is an identifier of up to 4 characters and un is 
the user nunuber to search first for files* 6 is the number of 
the system core ccinmand deck for the Arden Hills $2 
configuration. ijatai0^1.S£fi£i£llQa-C56-fla-illfi-4£Jl£Q-tiiiiS^-S3 
uLLl ilfisii:fli-tljs-£iasjfisi-stia£«£fi£aiiisfii.f ils-liasaA- i^ gener a i 

ffff and un will be the sanse* e*g* X*SETV£ (OAH>UN«OAH# Ca6l 

♦♦Only ONE SETVE should be done for each user number and a 
SETVE should NOT be done for ANY Integration user number 
except by the Integration project*** 

SEE SECTIOI^ 5.1 FOR H0»£ DETAILS. 

o Bring up dual state? 

NVEffff * 

where ffff Is the identifier specified In S£TVE# e*g* 
NVEINTl. 

Bring up the Operator facility 

Enter K,NVE* 

NOS/VE Is currently generated and initialized on both NGS 
and NOS/VE* All source and object libraries that make up the 
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4*0 DUAL STATE OEAOSTAP.T AHQ OPERATION 
4.6 NOS/VE OEADSTART AMD IHSTALiATION 



NOS/VE system are produced on NOS and therefore tiust be 
converted froi their CI to II counterparts* Other parts of 
Installing and initializing the systefR Ce»g« by 1 1 ding the 
SSYSTEH catalog! are performed by conifliand language procedures 
on NOS/VE* Since the sa^e system will many tliaes In a closed 
shop environment* it Is advantageous to only perforni the 
conversion froj^ CI to II a single tlwej save the results In 
the NOS file system and then sijsply bring the files back 
dur Ing deadstar t« 

The actual files that get Installed and loaded on each 
deadstart are determined by a comsjand language procedure (the 
systems profile) Interpreted on NQS/VE. This procedure can be 
modified by each site to initialize their NOS/VS environment 
in the most suitable fashion. The process of building the 
system profile and of performing the CI to II conversions Is 
referred to as an installation deadstart and the process of 
executing the system profile and of fetching previously 
converted files from HCS and making them available In the 
NOS/VE file system Is referred to as a deadstart. A single 
command is available to perform both an installation deadstart 
and a deadstart. 



4.6.1 THE OS PROCEDURE 

The purpose of this command is to perform an installation* 
normal or recovery deadstart of NQS/VE. The defaults for 
parameters are those most convenient for "closed shop*' 
deads tarts. 

The procedure "brings up" the job log display on the left 
screen where the progress of the procedure may be watched* and 
the control point display on the right screen. Just before 
the procedure completes it changes the left screen to display 
the system log and writes to that log the message? 

f Deadstart Completed "■ * 

at which point the operator may enter commands. 

ds Cklnd«instal I * norrral J recoverl 
tget_products*<boo I €an>3 
Cscho«<bool ean>3 

Cal ter nate.user«<H0S_us€r.name>3 
Csave^instal l.f 1 1 es*<boo lean>3 
tval ldate_users«<boclean>l 
Cgui ck^val ldate«l is t of <name>3 
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4.0 DUAL STATE DEAOSTART AND OPERATION 
4.6.1 THE OS PI^OCEOURE 



£statys=<status var Iat3le>3 

kiRd • ks This parameter specifies nfiat kind of deadstart Is 
to be performed. Valid specifications ares 

install ' I - Installation deadstart to be per foriued. 
The system libraries are built froffl CI object 
files . 

noriaal * n - normal deadstart to be performed. The 
systeai libraries are obtained frots tfie results of a 
previous installation deadstart. 

recover « r - recovery deadstart. Just initiates systeai 
tasks. Permanent files are "recovered** froi a 
previous run of the system. 

Omission will cause a recovery deadstart to be 
performed. 

get.products * gpt This parameter specifies whether the object 
libraries deflnirg the current product set and SCU 
libraries defining the source libraries are to be 
installed. Valid specifications are: 

true ! yes ' on - the products are to be Installed 

false I no » off - the products are not to be installed 

The list of products installed on the Arden Hills 
closed shop S3 system when get^products«yes Is specified 
is given in the IMSTALl.PtOOUCTS section. 

Omission will cause the product set to be installed. 

echo J e? This parameter specifies whether the commands should 
be echoed to the console during execution. Valid 
specifications ares 

true « yes S on - echo commands 

false * no * off - do not echo commands 

Omission will cause commands not to be echoed. 

al t er nate^user * auJ This parameter specifies what NOS user to 
check if the default HVE user does not have the needed 
file. Any NOS user name Is allowed. 
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4,0 OOAt STATE OEAOSTART AND Of»EI?ATIOH 
4,6. i THE DS PROCEDURE 



Owl ss Ion will caysa INTl to be used» 

val Idate^ysers » yy? This parameter specifies i«hether to run 
the Job that validates NOS/VE users. This paraiueter is 
ignored for a recovery deadstart* Valid specifications 
are? 

true J yes I on - run the validation job 

false • no I off - do not run the validation job 

Omission tiill cause the validation job to be run* 

qui ck.val I date * qvs This parameter determines which users 

will be validated by the validation job If It is run. 

yhen specif I ed# this parameter gives a list of user names 

to be validated In addition to the users J INTlf INT2# 
0£V1# DEV2# tELl# EVAL and RKC. 

Omission will cause all users to be validated* 

status! See ERROR HANDLING In the MOS/VE ERS. 
HOT ES 

The get.source.l I br ar i es parameter has been reffloved* Source 
libraries are now treated as products and their installation 
Is now controlled by the get.products parajueter. ! 

The debug parameter has also been rewoved. Later in this \ 
document there is an explanation of how DS now handles t 
abnormal situations* { 



iuffiiAti.ii£.QS.£tfia££siQg 



I» N> R A condition handler Is established for 

any fault* If something goes wrong 
during the DS procedure* It will get 
control # display the status* and let 
the operator Interact with the DS 
procedure* The operator can enter 
coinmands to investigate and/or correct 
the problem* resume execution of OS by 
entering CQNTINUEf or abort DS by 
entering EXIT.PROC* 
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If Mf R The procedyre "brings up** the job log I 

display ion the left screen! where the t 

progress of the OS procedure suay be J 

MatchecSf and the control point display * 

Con the right screen). i 

I only System files are created from 170 CI * 

binar ies for I 

CyF$RUM_TIHE.iI8RARY \ 

OSFSOPERATQR.ilSRARY J 

OSFSSYSTEH.LISRARY I 

OSFSOPERAT0R.COHHAN0.1I8RARY J 

QSFSCOHMAND.IIBRARY t 

If save.l ns ta 1 1 .f 1 1 es«yesf the II I 

binaries of the above files are ' 

replaced on the 170 • I 

N only Systeii files are accessed frojR 170* I 

these are the replaced II binaries J 

mentioned above* 1 

If Hf R Remote Host Output Is started* * 

Ip H System and User Prologs and Epilogs 1 

are bui It* J 

If H The validation Job Is submitted and I 

systew statistics are output* 1 

If N If get.products-yesf the product set \ 

and source libraries are instaliedi * 

failed product set or source library I 

Installations Mill print a Job log* * 

If H Wait for validation job to complete* \ 

If Hf R RHINPUTf IFEXECf DUMP.3R0KEN.J08 tasks I 

are started* J 

If N Feedback capability set up* J 



If Nf R SCL task started* \ 

Job I og prl nted* i 

The following message Is output? I 

— Dead start Completed — J 
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4.0 DUAL STATE DEAOSTART AND OPERATION 
4. 6,1 THE OS PROCEDURE 



The biggest change to the t)S proceclure Is In tlie prodyct 
set Installation (g€t«products*yes) « A procedyre called 
INSTALL^PRODUCTS is ystd to install tfie entire prodyct set 
Cpr odyct set and soyrce libraries}* In this pfocedyre# a job 
is sybil It ted for eacli prodyct* In each Job a G£T_PI?OOUCT Is 
execyted. The prodycts are installed in the SSYSTEH* LIBRARY 
catalog ynder the product naiae* The syb?altted Jobs can be 
yleiied on a right H display^ the left K display shows the 
processing of the OS procedyre. 

Upon job completion* a syccess or fallyre inessage with the 
job name (reflecting the prodyct being installed* i .e* 
cyi ScojppI ler for product cyfScowpller - the CYSIi II Coispller) 
is written to a statys file (dsfSprodyct^Job. status ) • The 
contents of this file Is ysed to make syre all the product 
jobs have completed before continying with the OS procedure* 
as well as the contents being displayed to the job log i^hich 
can be viewed by the operator* 

If a product Installation fails* several things happen: 

- A failure Brassage with Job name is written to the status 
file* which wilt subsequently be displayed to the 
operator* 

- The job log for the failed product installation will be 
printed* indicating the error* 

~ At the en4 of the IHSTAIL^PROOUCTS procedure* if any 
products have failed* the condition handler established 
at the start of the OS procedure gets control* A status 
message of "n pr oduct I nstal I at ions failed'* is displayed 
and a prompt fcr operator interaction occurs* The 
operator at this point can attempt reinstallation of 
failed prodycts through the use of INSTALL. PRODUCTS or 
just continue with the OS procedure* 

The INSTALL.PRQDUCTS procedure can be used as an 
Independent command to do an instal latl on/r el nsta I i at ion at 
the operator's discretion* 

If get.products«y es* all of the following will be 
instal I ed« 
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4.0 fSUAl STATE DEAOSTART AND QPERATIOH 
4»6«1 THE 0$ PROCEDURE 



C170 Pro duct Name 

£ii£ i£lM.£il£l £li£.a£Qt£Ql;s 

cyfllc CYFSCOHPILER CYBIl II Compiler 

alfol ALFSOBJECT.IIBRARY 180 Assembler 

scfol SCF$08JECT«LI8f?ARY Source Code UtHlty 

scfcl SCFSCONHANO^IIBPARY Source Code Utility 

••stand-alone** coroaiand 

I ibrary 
iffedit IFFSEOITOR Jack Bohnhoff's Editor 

psfcl PSFSCOMHANO. LIBRARY Product Set Coi^mands 

aaf44d AAF$440_II8RARY AAH library 

aaf4dd AAF$4D0_II8RAR Y AAM-Fortran Interface 

cbf7dd C8F$7DD«LIBRARY Cobol Compiler 

cbf4dd CSF$4DD.LIBRARY Cobol Ryn-Tlfie Library 

ccfllb CCFSLIBRARY Common Compiler Hoduies 

cgfllb CGFSLIBRARY Common Code Generator 

dbfllb OBFSLIBRARY Debug Library 

fcfllb FCF$LI8RARY Fortran ConipMer 

flflib FtFSLIBRARY Fortran Run-Time 

fflifllb FMFSLIBRARY File Hanageinent U 1 1 II ty 

ffllflib HLFILIBRARY Hath Library 

swifllb SHFSLIBRARY Sort-Herge 

ttflib TTFSTEST.TOQL. LIBRARY Test Tool Library - ACR 

£ Examine 
osfpll QSFSPRQGRAM^INTERFACE.LIBRARY Operating Systes? Program 

Inter face 
osfsl OSF$SOURCE. LIBRARY Subset of Operating 

Systeui Source Library 



I!ilIALU£EOay£n«E£.a£SiiU£j 



ins tall^products Cproducts«l ist of <naine> * all3 

Csta tus«status_varl able 3 



products J product * ps the nawes of one or products to be 
Ins tai I ed« 

Omission nIII cause all products to be Installed* 

status! See ERROR HANDLING In the NOS/VE Command Interface ERS 
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££I-.EE0aii£I-££fi£J^^MO 



gat_pf©<iyct product «<f^affle> 

f i le«<170.f i le_na^e> 

user «<170.yser^na!ne> 

Ccataloga<180.catalog.ref erance>3 

Cf H e.con tents«<na«€>3 

Cf i I e.str yctur e«<naaie>3 

Cf 1 1 e_pr oc€ssor«<na»e>3 

Cr ing.attr lbutes»nst 3«»3 of <integer>1 

Cstatus«s tatus^v ar i abl el 



product « pt name of the product 

file J fJ naj!ie of the 170 file that contains the 856 for?!! 
of the product* 

user i yJ name of the 170 user that owns •'file'** 

catalog I ci naiie of the catalog In which the product Is to 
be instal led* 

Omission Mill cause Suser to be used* 

f I le.contents * flle^cntent • fcs the value for the product 
file's f I le.contents attribute* 

Omission «lli cause object to be used* 

f I le^structure 1 f s J the value for the product file's 
f 1 1 e.structur e attribute* 

Omission will cause library to be used* 

f I le. processor V fps the value for the product file's 
f 1 1 coprocessor attribute* 

QiRlsslon will cause unknown to be used* 

r I ng^attr I butes J ras the values for the product file's 
ring^attr Ibutes attribute* 

Omission will cause fll^llyll) to be used* 

status! See ERROR HANDLING in the NQS/VE Command Interface ERS 
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4.0 DUAL STATE DEADSTART AND OPERATION 
^•6.1 THE BS PROCEDURE 



If you change any of the following decks you MUST use the 
Installation deadstart fron? your own catalog Cwith files 
CYBIlSOf XiJOCH, XtJOSl and XLJIIB)* or you liust use the 
al t ernate^user paraiaeter to specify a NOS catalog containing 
the files Ce.g. DEVI). 

AVMUTIt CLHDP OHMDISA ICHCLOS ICHFAI ICHFAPC ICHFISH ICHGET 

ICHQPEN ICHPUT ICHWIOP IFMEXEC III1A72H IIM0C2S IIHRLE 
IIMRSE IIHRUH IIHRUSH IIPITDEl QC^ADD 0CM8IH 0CM8IN OCHCOL 

OCMCOH OCHCPY QCncm QCHDEF OCHDEl QCHDLB OCHONL 
OCHDOl OCHEND OCHGEN OCfllCH 0CMLH6 OCHLP OCHHUR 
QZnm QCH08J OCMOFH QCMQHS OCHRCH OCMRED QCMREP OCHRHB 

OCHSAT OCHSOL OCMVEL OCHViU OCHVOl PFHDC PFHTALL 
PUHBCAT PUI^BCYC PUHSFIt PUHBFO PUHBtST PUHBPF PUHSSET 
PUMCQHN PUHCRAK PUMPURG PUHCRAK PUHIQ8F PUHIIST PUHHISC 
PUMPURG PUMRALl PUMRCAT PUMREC PUMREF PUHRFIL PUHRPF 
PUHSTU8 RHHIHI RHHQAT RHHQOP RHHQRE RHHSFH USORT UTHOUR 

UTHPCl UTHPC2 UTMPC3 UTHPC4 UTfiPCS UTMTSA UUSERl 



4.6»2 EXAHPLE OF HOS/VE IHSTAllATIQN DEADSTART 

Type 

K^NVE. 

K.SETLA Cyour_un*NVE) your. pass word 

K.GETF OS Unseat 

K,0$ INSTALL GP«NO AU*scat 

4. 6.3 EXAMPLE OF NOS/VE *'N0Rf1AL'* DEADSTART 

The Integration system has had the installation deadstart 
run on It. Also tl^e files produced by the Installation 
deadstart have been wade semi -pr i vate and are found on the 
catalog used In the NVExxxx call. 

Type (where DEVI Is the same as the xxxx In the NVExxxx 
call): 

KfNVE. 

K.SETLA CDEVlfNVE) DEVIX 

K.GETF OS 

K.DS NQRHAL 
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4.0 DUAt STATE OEAOSTAP.T AND OPERATION 
4*6.4 EXAMPLE OF NOS/VE RECOVERY OEADSTART 

4.6.4 EXAMPLE OF NQS/VE RECOVERY DEAOSTART 

This is tha kii^d of deadsttrt that should most frequently 
be done %n a "closed sliop** envlronaient and consequently Is the 
one for which all the parameter defaults are oriented. It 
PTBs\MPpQ%%s that permanent file recovery has been successful. 

Type (where DEVI Is the same as the xxxx In the NVExxxx 
cal 1)8 

K#NVE. 

K.SETLA CDEVlfNVE) DEVIX 

K.6ETF DS 

K.OS 

4.6.5 EXAMPLE OF MINIMAL HOS/VE DEAOSTAf^T 

The lulnlfflal dsadstart shown below may be useful to OS 
developers who need to get the systen up quickly and do not 
n^e4 the product set or all validated users. 

Type 

K,HVE. 

K.SETLA (your^un* NVE) your. password 

K.GETF OS Unseat 

K.OS NORMAL GP^'NO QV^your.un AU^scat 

4.6.6 USE OF THE QUICK.OE ^OSTART COMMAND 

This cofliaiand is intended as a developiient tool to 
facilitate »fast« deadstarts where recovery Is not needed? 

indeed* if this command is entered £fi£ai££a£ aiii Qfit tl& 

£££la£ifiil when the system Is brought down for whatever 
reason. Specifying this command will cause an Installation 
deadstart to take place. If the IHITDD command is not 
specified then a default value of •VSNOOl* is used for the 
system deadstart device. Use of INITDD will allow setting the 
deadstart devices identifier to any value. THIS COMMAND ilLL 
NOT BE ACCEPTED FROM A DEADSTART COMMAND FILE* SO «D=T« MUST 
BE SPECIFIED ON THE SETVE PROCEDURE TO PERMIT ENTRY OF THE 
QUICKOS COMMAND. 

Format* QUICKDS or QUICK.DEADSTART 

Values J The default Is false. Executing this command 
causes this initial value to be toggled* thus executing this 
command twice will cause the final value to be false. 

Notes QUICK.TEMPLATE_LOAD does not exist now. 
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4.7.1 OPERATOR IHITIATIOH 

To bring up the NOS/VE interactive facility do the 
f ol fowl ng? 

1) Bring up HOS/VE. 

2) Bring up mn 

At the system console enters 

For 9,l/5Fs For 9.2/5GS 

FCN#5f7700. ENABLE, NAHf 2. 

NANV2. HAH. 



With the 5G networks* a flashing request for a durop 
tape will appear, enabling the operator to dun»p a 
previous network crash itisi bringing HAH € friends up 
again. If you don't want a dump enter ASSIGN, Jsn, 77# 
for the appropriate job* 

3) If lAF Is not up at control point 1, enters 

For 9.1/5FS For 9.2/5G$ 

IAFV2. lAF. 



4.7.2 OPERATOR TERMIMATION 

4.7.2.1 Ifi£iinjiiao-flf-I-i££ifis«!i£ii!fli:lS5^r«2AiZS£ 

To terminate HOS/VE interactive any of the following may be 
dones 

- CFO,NAM.OI,AP=VEIAF. 

This Is the preferred method. To bring NOS/VE interactive 
back up, you must first do a CFQ,NAf1.EN, AP^VEIAF. 

CFO,NAH.OI,NE. 
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4»7«2.1 TerfRlnatlon of 1 Series NetworHs - 9»1/5F 



This teriRinates the entire network including IAFjRBF* etc* » 

To terminate NOS/VE interactive either of the foil owing siay 
be done* 

- Preferred wethodi 

K#NAH. 

K.AP«NVF. 

K.OI#AP«VEIAF. 

To bring VEIAF beck up# you must dos 

K#NAM* 

K,AP«NVF. 

K,EH>AP«VEIAF* 

X.DIS* 

IIPPAS. 

DROP. 



- Second methods 

IDIE^NAH. 

IDL£#IAF« CDon't Idle lAF when IAFEX2 Is executing 
or a ?9 Ml 1 1 hang. ) 



This terminates the entire network including lAFt RBF# 
etc. and should be used only If you have Ofi-lQifiEtlSO of 
bringing VEIAF back up because the 170 and 180 sides of VEIAF 
get out of synch when the network is brought down this way* 



4.7.3 OTHER OPERATOR CAPABILITIES 



- To logically turn the printer on* under DSD enters 

ON* 33. 
FORH*33*TH>. 

To send a "shutdown warning" to all terminals logged on to 
VEIAF dos 



Cycle 9f October 1982 



4-17 
NOS/VE Cycle 9 Helpful Hints 

4*D DUAL STATE DEAOSTART AND OPERATION 
^•T.3 OTHER OFERATOR CAPASIIITIES 



For 9.X/5FS For 9.2/5GS 

CF0*NAI1.ID^AP»V£IAF« K#NAM. 

K*AP«HVF. 
K,ID#AP«V£IAF 



- To send a iiessage tc all tersninals do: 

For 9,1/5F5 For 9,2/5Gs 

CFO#HAH«HSG#All#aiessag«» K>HAH« 



K.AP«CS. 
K*NPU=npur*aaje> mess age* 

npynaiii8«SH1147 on the $Zp 
-SN1322 on the S3. 



PASSQN has the afclfity to record various types of 
diagnostic Irjf onuatlon* This capability is controlled via 
the sense switches at the PASSON control point* To turn a 
sense switch on (offl at job jsn dos 

QHSy*Jsn#x« COFFSWf jsn>x») 

where x Is the desired sense switch CI to 6)# The PASSOH 
default is all sense switches off* It will take a short 
period of tlie before PASSON detects a change in a sense 
switch and reacts to it* The sense switches currently used 
by PASSON ares 

1 Network Trace 

2 PASSON Logic Trace To Dayfile 

3 Hemory Link Trace To Dayfile 



4*8 !i0S£i^£-.Q£££AIflS-£ACILlIl-4tia-Q£££AI0£«i:0Btl4^0a 



With the release cf the Operator Facility Phase 1 several 
changes to the NOS/VE Cperating System wi i I occur that will 
effect the users of the NOS/VE Operators Console* The 
Operator Facility runs as part of the NVE control point* When 
the request for K display appears on the NQS B Display* assign 
the K Display to the NVE control point. The Operator Facility 
Is capable of displaying both a left and a right screen area 
at the same time* If the operator wants both screens then 
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4.0 DUAL STATE DEADSTART AND OPERATION 

4.8 MOS/VE OPERATOR FACItlTY AND OPEI^ATOR COHHANDS 



type In KK» The cootefits of these displays are determined by 
the cowjuands entered by the operator* 



The left screen Is divided into four different areas* The 
top wost area Is the systew header which contains the current 
date and time* nfieiBory statist Icst and an operator action 
laessage If one Is posted. The operator action will include 
the job seqyence number of the owner of the message and 
•message cancelled* If the roessaae Is cancelled because the 
task has terminated* The next line contains the first 64 
characters of the operator action ff?essage <60 characters in 
stand alone). 

The next area of the screen is the mn\n output area. This 

area has the file name of OUTPUT* Any display coimnand can 

have its output directed to this area ^s well as any system 
coififl^and* 



The third area is towards the bottom of the screen* This 
area Is two lines long and contains the response area. This 
will contain error messages from system commands* The area is 
cleared Mh^n the next operator typein Is entered at the 
operator's console and received by NOS/VE* 



The fourth area is the prompt area* This will contain the 
status of the keyboard. If NOS/VE Is processing a copiwand* 
then the keyboard is locked and all type ins will be ignored. 
Mhen the keyboard Is I ocked# the message «data received by 180 
- keyboard locked* will appear at the screen's bottom. Nhen 
the keyboard is unlocked then any data in the keyboard buffer 
will be sent to HOS/VE. The bottom line Is the last line that 
was processed by Operator Facility. 

The right K Display has the file name OUTPUT.RIGHT. There 
is only one area on the right screen therefore the iiiain 
display area is 10 lines longer than the left screen area. If 
a dayflle display or CP display is shown on the right screen 
you will get wore lines of Inforination than on the left 
scr een. 



There are no default displays that come up automat i cal iy on 
either output display area* It Is up to the operator to 
decide the display the operator wishes to see. The only parts 
of the display that coire up autoinat I cal ly Is the system header 
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4,0 DUAL STATE DEAOSTART AHO Of>£RATIOtl 

4*8 NOS/VE OPERATOR FACIIITY AND OPERATOR CQMHAHDS 



display and the prompt area for keyboard status. 



The page wIdtN cf the screen Is 60 characters for 
standalone and 64 characters for dual state. The character 
set translation code Is the same as that for the current NVE 
Sufosysteffl control point* The escape code sequence for the 
special characters tc be typed has not changed* There ar e a 
fe« differences In the processing of data by the Operator 
Facility and NVE Subsystem}. 

II Do NOT end commands with a period* Periods are sent to 
NOS/VE* 

Z) The NVE subsystem ccimuands that begin with an asterisk Hill 
not be supported from the Operator Facility control point* 
If these coaifsands are entered from the Operator facility 
they will be passed on to SCI where an Illegal comisand will 
be Issued* 

31 Routing of console job data to a specific job by the 
•n«coaifliand« protocol will not be supported in dual state* 
This feature should work in standalone but will not be 
supported* 

4) No type ahead - coiuirands cannot be entered until the proinpt 
area shows that they are requested* 



There Is one new cofliroand to replace the current display 
commands* The entry points for Zdls# Zdlsb* and Sdls have 
been deleted* The new command is VEOISPLAY and has two 
parameters* The options are listed below* The values In 
paranthesls are the abbreviations* Note that this coroi^and 
does not begin with an asterisk (*)* This coiisnand will be 
processed by SCL and create a new system control point task to 
display It's data* Tfie user can have the same display type on 
each of the display areasf If the user so desires. 



Copland Name Display Type Screen Area 



Parameter Hatne Parameter Name 

DISPLAY. OPTIONS OUTPUT CO) 

DISPtAY.OPTION (DO) 
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4«8 NOS/VE OPERATOR FACILITY ANO OPERATOR COMHANOS 



Par teeter Values Parameter Values 

VEOISPLAY CVED) DIS PLAY.SYSTEM.LaG OUTPUT 

JOB^lOG i4U OUTPUT^RISHT COR) 

COHTROi.POIHT CCP) 

The default file na»e for all displays Is OUTPUT* 

The folloiiing is a trlef list of corBiaands to bring up NOSVE 
Nith the Operator Facility Installed* 



NVEffff* to fcrinsi up NOS/VE* (See Section 51 

K*NVE. 

KK* to bring up the K display on both screens. 

K.VED Jt to bring up the job log* 

or 

K.VED DISPiAY_OPTIONS«ai OyTPUT«QUTPUT 

to bring up the job log using key word 

identi f i ers. 

K.VEO CP QUTPUT^RIGHT 

to bring up the control point display on 

the r i ght screen* 
or 
K.VED OISPlAY_aPTIQNS«CONTRaL.POINT OUTPUT=OUTPUT.RIGHT 

to bring up the control point display using 

key word 

i denti f I ers* 

K.xxx senc any conijnand to NOS/VE. 



K.TERHINATE.SYSTEM to terminate NOS/VE. 

Note* After the DS procedure has completed execution the 
coflitBand to enter to hr Ing down the system Is TERHINATE. SYSTEM^ 
not TERHINATE.SYSTEM.JCB* Yes* this is the OPPOSITE of what 
It used to be. 
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4.8.1 DELETE.JOB.QUEUE I 0EIETE.J08.QUEUES I OEIJQ 

The purpose of this cojumanti is to delete all files from ttie 
Job input subcataiogy the print subcatalog or both* This 
co!«jiand Is only allOMsd frojB jobs with operator and or system 
pr I vi leges. 

del ete^job^qycue C<|yeu€_naroe= Input* outputs al I 3 

Cstatys«<status variable>3 

queue^nape I qn s This parasieter specifies froffl which 
subcatalogs files are to be deleted. Specifying 
INPUT will cause all files to be deleted from the 
job swap subcatalog and the Job Input subcatalog. 
Specifying OUTPUT will cause all files to be deleted 
frow the job output subcatalog. Ofnission will cause 
all to be used. 

status! See ERROR HANDLING. 

4.8.2 REBUILD^IHPUT^aUEUE J REBIQ 

The purpose of this coppand Is to rebuild an entry In the 
Known Job List CKJL) from information in the Systero Label of 
the file representing the job being processed. This coR^siand 
Is to be used during the process of recovering the Input 
queues during recovery deadstart. 

rebui Id^l nput.queue Cn8Pe»<naflie>3 

Cst atus«<status varlable>3 

name J ns This parameter specifies the file name of the 
file representing the job. An attempt is made to 
process the specified file within the catalog where 
job input queues are known to reside. 

status: See ERROR HANDLING. 

4.8.3 REBUILO^OUTPUT.QLEUE J REBOQ 

The purpose of this command Is to rebuild an entry in the 
Known Output List CKOL) from information retained in the 
System Label of the file representing the output being 
processed. This command is to be used during the process of 
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recovering the outpyt queues during a recovery dsadstart. 

refeul Id^output.queue C riaffle«<na«e>1 

Cstatus«< status varlatole>3 

narBai This paranicter specifies the file narae of the file 
representing the output* An attempt Is made to 
process the specified file within the catalog path 
of where job output queues are known to reside. 

status! See ERROR HANDIINS. 

Through the system console* enters 

Type 

X.DIS. 

USER*A»8* 

SET^f i lenaase. 

where f lien awe identifies the input file to be routed. 

ROUTE >f 1 1 enawe» DC«IP> F C»RH. 

4.10 CfliEifiyEillQti-aAiASIl^ftll 

In order to run NOS/VE In a dual state en¥lr onipentf certain 
hardware configuration rules must be In effect. All storage 
devices and channels that NQS/VE will request fl5ust be In a 
*down« state In the HCS EST. For more information on the NOS 
EST* see the NOS Version 2 Operator/Analyst Handbook* 
604 59310* Section 4. Refer to the E display. 

To run $2 S/N 104 in the standard configuration* channels Z 
and 32 iRust be downed as shown below. 



N*CH2. 
D0WH*CH32. 
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4.10.1 SYSTEM CORE COMMANDS 



Configuration Hanaseiaent (CM) system core coiunjands define 
the system wass storage device* The commands are described in 
detail 111 the NOS/VE Installation Comi^and Interface EPSp 
Section 3« The CM systess core commands define the hardware 
configuration of the systew device and the controller 
accessing the system device* An exaiaple for S2 S/N 104 Is 
shown here* 



SETOCT $7155.1 
SETDO $88 5.11 40C8) 



4*10*2 JOB TEMPLATE COMMANDS 



During an Installation deadstart* the Physical 

Configuration Utility CPCU) and the logical Configuration 
Utility (LCU) niust be run* The PCU Is run to describe the 
physical configuration that NOS/VE ^ay access* The LCU hIM 
logically Install all or part of the physical configuration 
and allow NOS/VE to access the equipment* Commands for both 
utilities are described In the HOS/VE Installation Coiismand 
Interface ERSt Section 2* 

The system device wMch was defined by the system core 
commands must the defined via the PCU* using the same 
controller and channel number* Additional devices mzy be 
defined as long as the device Is In a donn state* and all 
channels defined are also down* An exaisple is listed here* 

EXECUTE.TASK SP'^MANAGE.PHYSIC AL.CQNFIGURATION 
SET. MAINFRAME. DEFINITION HAINFRAME«S2 
SET. DATA.CHAHHEt. DEFINITION CHAHNEl.NyM8ER=2 
SET.DATA.CHANNEL.de FIN IT ION CHANNEL.NUMB£R«18 
SET.CONTROLLER.OEFINITION ELEMENT«CT1 *. 

PROOUCT.IDENTIF I CATION* $7155.1 *. 

SERIAL.NUMBER*2 CHANNEL.CONNECT I0N=CHANNEL2 
SET.CONTROLLER.OEFINITION ELEMENT»CT2 ** 

PRODUCT.IDENTIFICATION« $7155.1 .* 

SERIAL.NUMBER«3 CHANNEL.CONNECT I0N=CHANNEL18 
SET. STORAGE.DEVICE. DEFINITION ELEMENT«FM040.A *. 

PRODUCT. IDENTIFICATI0N«$885.11 SERXAL.NUMB£R«1234 ** 

UNIT.NUMBER«40(8) CONTROLL£R.CONNECTION«CT1 
SET. STORAGE.OEVICE. DEFINITION ELEMENT=FM040.B ** 

PR0OUCT.IDENTIFICATI0N«$855.11 SERIAL.NUM8ER«3456 *• 
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UHIT«NUMBER»40{8I C0HTR0LLER.C0NNECTI0N=CT2 
IMSTALL.PHYSICAL^CQNFIGURATION HAINFRAH£«S2 
QUIT 

EXECUTE.TASK SP»HANAGE«lOSICAL«.CONFISyRATIOH 
IN$TALL.iO€ICAL.CONflGURATION INCLUDE* ALL 
QUIT 



4.10.3 MULTIPLE VOLUHE CQRSIDERATIOHS 



If a configuration is ysed defining isyltlple jsass storage 
volumes* the execution of the PCU and LGU will only permit 
access to the systeir device. In order to bring additional 
volui^es online* the LCL must be run again. The user ^ay want 
to initialize a fresh volume. To do this* use the LCU 
subcommand IHITHV. To add a volume to the MOS/VE set* I.e. 
to allow NOS/VE use of the voluiae* use the LCU subcopwand 
AODHTS. An example Is shown here. 

EXECUTE^TASK TP^MANAGE.LQGICAL.CONFIGUATION 

IHITIALIZE.HS. VOLUHE ELEHENT«FHD40.8 RECORDEO.VSH' 'VSNOOZ' 

AOO.MEHBER.TO.SET M EHBER.VSH* » VSN002« 
QUIT 



During a nonlnstal I ation deadstart* an attempt will be pade 
to bring all logically configured voluines online and 
reactivate them. This means the above sequence need only 
occur when a new volume is being brought online the first 
time. 

Reference has been wade to the NOS/VE Installation Command 
Interface ERS. To get a copy of this document on S/N ICl* 
enter SES>HAD.LISTNIH. 

4.11 li«aiS£L4X-Ai£II 



Support of 6-12 ASCII from the console (K display) causes 
the following changesJ 

IM£yi IEM^LAI£O.IO miUl IEMiLAI£0.IO 

/I /< C 

/2 •• /) 1 
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/3 i 

/4 $ 

/5 (reversed /) 

/6 I 

n ? 

/8 C 

/9 > 

/O . Cunderscorel 



/ + 


> 


/- 


< 


jfsa. 


• 


/* 


• Cslngfe quote) 


// 


/ 


If 


5 



/A to /Z a - z (lower case) 



Host of the steps listed here are used to gather 

Information for recovery profoleros* etc* If you do not wish to 

do this* execute steps D and E only (EDO dump and NOS level 3 
deadstart ) « 

A. Enter DR I at the liDD display* 

B* Enter HP at the HDD display* 

C* If IQU.FSl NOT « OR I0U.FS2 NOT « THEN do NOT enter 
OU at the HOD display ELSE do enter DU at the HDD 
displ ay * 

0. Press deadstart button and perform EDDJ 

1) Mount scratch tape (ring In) on a 9-track drive, 

2) Push D/S bytton. 

3) Select U (utilities) display* 

4) Select £ ( EDO) display* 

5) Set channel (S2=13)* 

6) Set ECUU {S2«01uu) 

E « equipment 

C » 1 for 67X drives* 2 for 66X drives 
uu « unit number of the tape drive to be used* 

7) Answer ♦*duttp number" with a CR. 
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8) Answer ^non zero Inhibits rewind^ with a CR« 

91 Answer ♦*chann«l control ware** with i CR» Ml£BiCiJi 
If this step Is oislttedf OSDI canot process the 
dyiBp tape* 

£• Perforas a level 3 NOS deadstart I See Section 4.14), 

F« If you are runnlrg on the S3* enter the following at the 
conso le* 

X.DIS. 

USERf INTlflNTlX* 

GETfDHf»DFS/UN*JlG* 

8£GIH##DHP0FS. 



DROP. 



This Is a procedure to dump several dayf i les associated 
with the HVExxxx job and are needed along with the £00 tape to 
ade<iuately debug a NOS /VE hang. 

Soiie of the crashes that NOS/VE encounters will cause 
NOS/VE to terminate such that the operator will notice the 
K-dlsplay which requests that a K**RUN* fee entered. Sefore a 
K.*RUN. is entered the EDO should be performed* 

To create a listing of the EDO tape* type SES* INTl.DSOI See 
the procedure's HELP documentation for parameter 

descr iptlons. 

C170 OSDI Information can be found in Chapter 10 of the NQS 
SYSTEM MAINTENANCE Hanual. 

A170 OSDI info can be found in document ARH3060 — GID for 
A170 NDS/S2. 



4.13 tlQSZ)i£-I££MMAIiO^ 

o Bringing down dual states 
K»NVE. 
K.TERHINATE.SYSTEH 
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o If not a normal ten! nation 
K>NV£. 

K**ENOtST, 
K.*EHDRUN. 

4*14 AUO-iflS.SayiGQMi 

Before leaving the s^^achine* it is necessary to bring NQS 

down. If NQS has crashed* a level 3 deadstart ipust be 

attempted even If the cnly reason is to bring NOS down. To do 
a level 3 deadstarts 

1) Push D/S button 

2) Select *»0»' display 

3) Sel ect **l»" dl spl ay 
41 Enter 1=3 

51 Enter (CR> 

6) Enter date/ time 

If a dump is desired but a crash has not occurred STEP* 
should always be entered before pushing the deadstart button* 
After the dump has been taken a level 3 deadstart should be 
per formed* 

To bring NQS down* do the following: 

1) Enters 

CHE 

The screen will display: 
CHECK POINT SYSTEM* 
Enters carriage return 

21 Make sure no mass storage device has a checkpoint 
rquested* To do this* enters E*H* If the display shows 
there are no "Cs in the status field* then all devices 
are checkpolnted and you may continue* 

3) Enters 
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STEP. 
41 PusN deadstart button* 



Cycle 9» October 1982 



5-1 
HOS/\fE Cycle 9 Helpful Hints 

10/26/82 

5,0 RgCOVERY OF NQS/VE PERHA^ENT FILES 



5 . a££OM£EX.O£«liOSi.I£«E£BBAMEMI«£IL£i 



5.1 S£I^£-£OEiM 



The general format of the SETVE coaimand is 

)(.SETV£Cf>N«ffff,Uf^«yn#VSN=vsnf 0»d,P»Pf 8«b»C*c>CH'cii) 

ffff is a string of no more than four characters* SETVE 
zppent^s ffff to 'NVE* to construct the name of a 
procedure file whlch# when invoked* Hill deadstert 
NOS/VE. The default is TST* 

un specifies the user number from which TPXXXK is 
attached* Un Is the first catalog searched for 
other files used in deadstartlng and terminating 
HOS/VE. The default is IHTl* 

c specifies the deadstart cofusiand deck to be used when 

deadstartlng NOS/VE* The function served by the 
deadstart command deck is analogous to the function 
served by the CMRDECK of NOS» Currently supported 
values for c and their respective uses are: 

1 Arden Hills S3 S/N 02 open shop/hands-on time 

3 Arden Hills S3 S/N 02 closed shop 

6 Arden Hills S2 S/N 104 open shop/hands-on time 

10 Sunnyvale S2 closed shop installation 

40 Sunnyvale S2 closed shop continuation 

The default is set in the file CHDSl. Currently 
the default is 6* Ma£XliOai«S2££i£liQfl £«& aU thfi 

ALil£a-.«eiiii— Sa-^aiii— iifisi£X2i-i:fcis_liQSZ^£-as£jBjQ£ct 

b specifies an alternate catalog to be searched for 
the various files used In deadstartlng and 
terminating NOS/VE* The default Is INTl. 

d is used to indicate that the system core command 
processor should accept commands from the console* 
Specifying D«T In the SETVE command allows the 
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5.D RECOVERY OF NQS/VE PERHANENT FILES 
5,1 SETVE FORMAT 



operator to enter cowiands frow the console after 
processing the deadstart command deck* If the 
operator wishes to initial ii^a the system device 
and/or install a new version of NOS/¥E» 0«T must foe 
specified. The defaylt Is set in the file CHOSl* 
Currently the default is D«F« 

p specifies the password for the catalog indicated by 

the un parameter* If this parameter is omitted the 
password will be generated by appending an *X« to 
the UH parameter* 

ch specifies th€ octal channel to be used for NOS/VE 
disk I/Q« The default Is set in the file CHDSl. 
Currently the default Is 2» 

vsn specifies the vsn of a deadstart tape. If this 
parameter is used then NOS/VE will be deadstarted 
frow the tape specified* If it Is omitted* then 
NOS/VE will be deadstarted fro^ the permanent file 
TPKXXK* 



5.2 S£I^£-ySM£ 

Earlier versions of NQS/VE rei^ulred that two SETVE commands 
be issued if the system was to be installed and subsequently 
recovered* The current system does not require this. The 
only reason for Issuing two SETVE commands is to provide a 
deadstart procedure that does not require/permit operator 
Inter vent Ion* 

It should be noted that once the SETVE command has been 
issuedf it need not be issued again unless**. 

1) There Is a need to change one or more of the parameters 
sped f I ed In SETVE* 

Z) The command f I le* NVEf fff* generated by the SETVE 
command is purged from the system* 

Two examples of SETVE usage and subsequent HOS/VE deadstart 
are given below* The first example shows a "hands on" user 
working with recovery* The second Illustrates these concepts 
for a typical NOS/VE closed shop* This writer hopes that the 
reader will find both examples useful and illuminating* 

I* A "hands on" user 
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The cofflwand file NVERSO Is built and installed In NOS 
by typing 

K«$ETVECRSD*UN»RSOfVSM«TAPEf 8«C)EV1#C*6#D=T) 

Several of the choices of parameters are worth 
noting* 

13 By specifying the VSN parameter the user has built 
a coBimand file that will deadstart the systes? 
directly froai the tape produced by NVESYS* 

Z) The user In this exawple has specified deadstart 
coiBi»and deck 6 (C para^eterl and has allowed the 
NOS/VE dIsN I/O channel < ch parameter) to default 
to 2« Ore concludes that the user is running on 
the Arden Hi I is S2. 

31 The user has specified D«T. This is important. 
The deadstart comn^and which triggers Installation 
of a recoverable systsp cannot be read fron? a 
deadstart cossnuand deck* It must be entered froa? 
the console at deadstart tiroe. Specifying D=T 
allows the operator to enter coaitnands frosi the 
con so le« 

NOS/VE Is deadstarted by typing 

NVERSD. 
at the console* 

The user brings up the K display by typing 

K#NVE* 



Presently* the deadstart comaiand deck is displayed 
and the user is prompted for Input. The deadstart 
command deck used in this example looks like th I s s 

USECP S2CFIG 

USEIP EMPTY 

SETDCT $7155.1 

SETOD $885.12 32 

The user types 

K*IMITDO VSNOOl* 
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K.GO. 

The system accepts the coiajnands and i ns tal Is and 
deadstarts HOS/VI* 

After the system comes down* via either controlled 
tersil nation or a crash* the system can be recovered (if 
necessary) and r edeadst arted fey typing 

NVERSD* 

When the deadstart coflimand deck Is displayed* the 
user types 

K*GO. 

This will cause NOS/VE to be deadstarted without 
initialising the systens device* 

II. A typical •'closed shop** 

Two corRinand files* NVECISH and NVEINST* are created 
by typing 

X.SETV£fCLSH*yN«ClSH*8»DEVl*C«<^0*CH«l) 
X.SETV£(IHST*UN»CISH*S«0EV1*C«10*CH^1*0*T) 

One notes that 

1) Closed shop is deadstarted from a TPKXXK file in 
the CLSH catalog* 

2) Specifying 0=T* for NVEINST* causes deadstart to 
pause for operator intervention. 

3) Using DCF deck 40 for continuation suppresses 
redundant Cand possibly dansaging) reexecution of 
the configuration prolog. 

A normal deadstart Is used when bringing up NOS/VE at 
the beginning of closed shop or following a systeip 
failure. The operator* in this example* types 

HVECLSH. 

NOS/VE will recover I If necessary) and deadstart. 
When recovery runs* the operator must respond to a 
request for Input from the MANLC utility. See note 4 at 
the end of this section for more information. 
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If it is nacessary to reinitialize the system device* 
or If the Installation is upgrading to a new version of 
NOS/VE> the oper ftor keys 

NVEIHST. 

This causes deadstart to pause and «ait for operator 
Input when deadstart commands are being processed. 
There are two cases requiring discussion here. The 
first is the case of upgrading to a new and compatible 
version of HOS/VE. The second case Is used only when It 
Is necessary to reinitialize the system device. 

The first case Involves the Installation of a new 
version of NOS/VE. In order to Install a new version of 
the systeBJf the old system lust have been Idled In an 
orderly way. A new systen cannot be Installed lf> 
following a crash* the system being superceded was not 
recovered. Assuirlng everything In the old system Is 
tidy# and the file systems are compatlblef the operator 
keys 

K.USECP EHPTY. 

K.SETSA INSTALL. JOB^TEHPIATES 1. 

K.GQ. 

when the system displays the deadstart command deck and 

prompts for Input. The new system is installed* the 

file system is preserved* and deadstart proceeds. 

The second case amounts to an Installation 
deadstart. This should be used only with full knowledge 
that any files which may have existed on mass storage 
prior to this deadstart* Miii-llfi.lilflSJtfiil^ iotfi 2hiLtiStQ 

An Instaltatlcn deadstart will be required if 

1) This Is the Initial Installation of a recoverable 
version of NOS/VE. 

2) If the file systems of the system being installed 
and the system being superceded are not 
compat I b I e • 

3) If the file system has been damaged beyond the 
possi bi I i ty of recovery. 

An installation deadstart is effected by typing 
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K*INITDO VSNOOl. 
K • • 

when the deads tart comm&nd deck Is displayed and the 
operator Is prompted for Input. 



NOTES 



!• The CHOSl file used to deadstart NOS/VE isust have 
the 0EBUG2 flag set to TRUE. ihen NOS/VE Is 
deadstarted> the catalog specified by the UN 
paranieter is first In the search order for CMDS1> 
followed by the catalog specified hy the B 
parameter • 

2. See Section 3.3 of the Integration Procedures 
Notebook for other Information about the CHOSl 
file. 

3« If NOS/VE crashes and a 4ump is desired (in the 
context of our second example) 

I* Type du at the HDD console. The message 

••URITIHG IHAGE FILE" should appear 

Immediate ly* The message "IMAGE FILE 

COHPIETE" should appear a few aiowents 
later. 

II. Push the deadstart button* 

ill. Take the EDO dump. 

iv. Do a level 3 NOS deadstart. 

Alternatively the operator can skip step i if 
she/he Is sure to redeadstart NOS/VE after step 
iv. In this event the system will detect that the 
iwage file Mas never created^ will create one* and 
«HI recover from It. 

4. A recovery deadstart which is under the control of 
a SETVE command in which D=T was specified will 
pause in the recovery system with the message 
"OPERATOR INTERVENTION BEFORE RECOVERY BEGINS". 
The system is executing the logical configuration 
utility at this point. In order to exit this 
utility and allow recovery to proceed the operator 
types K.QUIT ino period). For more details on the 
use of the LCU see Section 4.9 of this document 
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and the NOS/VE Installation Comfnand Interface 
ERS. 
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The SysteflB Core debugger provides a set of capabilities 
Intended to assist In debugging the operating systero* 
Services provided by the debugger are task oriented J selection 
of the tasks to be debugged must be made via debugger 
subcoppands* No tasks will be under control of the debugger 
unless they are selected. The selection capability allows any 
number of tasks to be debugged simultaneously! from one task 
to all tasks In the system. Obviously a capability this 
pot«erful must be used with sope care. The Systei^ Core 
debugger uses the debug hardware to provide these 
capabi I It les. 

6.1 Hsa£fiys 

The purpose of this cosunand Is to Initiate execution of the 
system core debugger. This comipand can be Issued fron? the 
deadstart coisn^and file or as a coinfsand In any job. 

sys debug 

This command has no parameters; all Information the 
debugger requires is provided via subcommands. 

The system core debugger can also be Invoked from the HDD 
console. The format of the command Is? 

DO n.sysdebug 

Mhere n Is the job ordinal of the desired job. The debugger 
Is brought up In the jcb monitor task of the Job. All system 
core debugger subcommands are aval lab I e> but must be prefixed 
by the MOD command DO. 

The system core debugger can also be brought up (from the 
HDD console) by specifying a global task Id. The format of 
the command Is? 

DO n.tdebug gggggg 

The value of n is Ignored* and the value gggggg specifies the 
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NOS/VE global task id 
debugger up ln« If 
wH I be I gnored* 



13 hex bytes) of the task to 
the task Id Is invalids then 



bring the 
the coii5iiand 



6. Z SyBaQaMifi.EiSiia£I£E-M£IMIIiQiS 



<najiie> ss« 1~8 character breakpoint name 

<conditron> 5S= READIWEITEI RHI! BRANCH iCALl fOIVFlT J ARLOSI 

AROVFlJEXOVFLIEXUNFtJFPtaSIFPINOEFIINVBDP 



<bas8> • 
<of fset> 

<length> 
<fr a?Be> 
<count> 
<regl d> 
<regno> 
<va lue> 
<tlwe> s 
<vs tr lng> 



« process virtual d^64rB5s 
!2« Integer 
5S= Integer 

1«. 10000 

X * A ' P 

0..15}0..0F{16) 
?- Integer 
« l..{ 2**31 )-l 
!5» 'charstrlng' 



<datatype> ss« HEXJ ASC III ASCS DEC 
<change.count> S2« 1»«8 
<selector> si« FULII AU1Q1SAVE 



6, 3 siii£M«cfl££-i2£ayfiS£a«syii£QiiiAMaa 



Within the descriptions *«hich follow* optional parameters 
are enclosed In brackets. Default values for optional 
paraiseters are also defined. 



6.3.1 SELECT 



The purpose of this subcosimand is to select the tasks in 
which the system core debugger Is to be active. yhen the 
debugger Is first called* it is not active in any task. To 
use the debugger therefore* it Is necessary to select the 
tasks in which It Is to beactlve. 

select <selectlon optlon> C<rlng number> * <active job list 
ordlnal>l 

sel ection. opt ions This parameter specifies one of a 
series of selection options used to control the 
tasks in which the debugger will be active and sofse 
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other debug options* The selections are refnain in 
effect until they are explicitly changed with 
subsequent SELECT subcoffijuands. Valid selection 
options are: 

<right«left> - This selects the screen for the debug 
display. The display stays active when the screen 
is switched. 

Kjobmoni tor * nojobmoni tor> ~ This selects whether or 
not to debug Job monitor tasks. 

<user Inouser > - This selects whether or not to debug 
user t€S*cs (i.e. those that are not job 
won I tors). 

<highrlng> - This specifies the highest ring In 
which debug traps will be recognized. Traps 
occurring In rings above this selection will be 
ignored. 

<job»nojob> - This enables or disables debugging for 
the jot at the specified active job list 
ordinal. The system job has an active job list 
ordinal of zero. 

<al I jobsSno jcbs> - This activates or deactivates 
debugging In all jobs. 

The Initial selections ares RIGHT* NOST£P> 
HOJOBMOHITOR* NOUSER* HIGHRIHG=3# HQJOSS. 

6.3.2 BREAKPOINT \ 8 

The purpose of this subcommand Is to select a program 
Interrupt which Is to take place upon occurrence of a 
specified condition within a specified virtual address range. 

breakpoint <na}«e> <condltion> C<base>3 C<offset>3 C<length>3 

The <name> Is any user supplied name for identifying the 
breakpoint. A maximum of thirty two breakpoints can be 
selected. When a trap occurs* the <name> of the breakpoint 
which caused the trap Is displayed. 

The base parameter is required when specifying a new 
breakpoint namei offset and length specifications are optional 
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In this case. When adding a nen condition selection to an 
existing breakpointf base# offset* and length parapeters fliay 
not be specified. 

8ase# offset* and length parameters define the desired 
virtual address range* <base> + <offset> yields a 
f Ir st-byte-addr ess; first-byte-address + <length> -1 yields a 
last byte address. 

Default parameter values? 

<offset>s 
<lengtb>J 1 



6.3.3 REHOVE^BREAKPOINT \ R8 



The purpose of this subcoiaiand Is to deselect a previously 
selected prograffl inte 

reffliove^breaKpoint <naine> C<cond i t ion> 3 

If only the naiue parameter Is specified* all conditions 
associated with the breakpoint are deselected and all evidence 
of the breakpoint Is removed. If the condition parameter is 
specified* only that condition is deselected; tioviever* If the 
specified condition is the only condition selected* all 
evidence of the nained breakpoint is reiijoved. 



6.3.4 LIST^BREAKPOINT J LB 



The purpose of this subcommand is to provide a list of 
currently selected brefkp and associated conditions* 

I lst.br eakpoi nt t<na3ie>3 

If the name parameter is specified* lnfor?nation is 
displayed for the named breakpoint only. If the name 
parameter Is not specified* Inf or!»?a tion Is displayed for all 
currently defined breakpoints. 
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6. 3,5 CHAHGE^BREAKPQIHT I CB 



The purpose of tfis subcommand is to change the virtual 
address range of a prevl specified breakpoint. 

change.br eakpoint <naffl€> <base> C<offset>3 C<lengtfi>1 

Basej offset* and length parameters define the desired 
virtual address ranges <base> •»• <offsat> yields a 
f ir st-byte-addressi f I rst-byte-address + <lengtb> -1 yields a 
last byte address* 

Default parameter values? 

<offset>5 
<lengtb>5 1 



6.3.6 TRACE.BACK i TB 



The purpose of this subcommand Is to provide information 
relevant to stack frame associated with an Interrupted 
procedure and Its predecessor procedures. Validation of PVA*s 
is now performed. 

Information displayed for each selected stack frame 
consists of: 

- Stack frame number? 

- Current ^-address of the associated procedure; 
Virtual address of the start of the stack frame j 

" Virtual address of the stack frame save area. 

trace. back f:<frame>3 C<count>3 CFUli;SH0RT3 

The frame parameter specifies the number of the first stack 
frame for which Information Is to be displayed. Stack frame 
number one Is associated with the Interrupted procedure* stack 
frame two Is associated with the interrupted procedure's 
predecessor* etc. 

The module name provided on the traceback Is usually 
correct but not guaranteed. 

The count parameter specifies the total number of stack 
frames for which Inforiration is to be displayed. 
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6.0 SYSTEH CORE DEBUGGER 
6.3,6 TRACE^BACK \ T8 



Default parameter values: 
<fraf!ie>s 1 

<C0Uflt>5 I 



6.3*7 DISPLAY.STACK.FRAHE S DSF 



The purpose of tills subcofRiaand Is to display selected 
Information from e specif i stack frame* 

displ ay^stack.frasie C<fraBje>1 i:<sel ectof>3 

The frame parameter specifies the number of the stack fraaie 
for which Information Is to be displayed* CStack frame nut^ber 
one Is associated with the Interrupted procedure^ stack frame 
two Is associated with the interrupted procedure's 
predecessor* etc») 

The selector para?neter Identifies a region of the specified 
stack frajae: 

AUTOS Causes the automatic region of the stack frame to be 
dl splayed* 

SAVE? Causes the save area of the stack frame to be 
dl spl ayed* 

FUits Causes both the automat Ic and save areas of the stack 
frame to be displayed* 

Default parameter values? 

<frame>5 1 
<selector>5 FULL 



6.3.8 DISPLAY.REGISTER J OR 

The purpose of this subcommand Is to display the contents 
of a specified reglste Interrupted procedure* 

displ ay^reg Ister <regld> C<regno>l C<d8tatype>3 

Default parameter values? 

<regno>2 
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6.0 SYSTEH CORE DEBUGGER 
6«3.8 DISPLAY^REGISTER S 01? 



<datatype>? HEX 

6*3,9 OISPIAY.^^EHORY J m 

The purpose of this subcomfnand is to display the contents 
of a specified area of virtual isewory. Validation of PVA's Is 
now performed* 

displ ay^mefflory <base> C<length>3 

Default parameter values? 

<length>s 8 

6.3a0 CHAMGE.HEHORY J CH 

The purpose of this sui3C0«ifnand is to set a specified value 
Into a specified loca cf virtual mefnory for a specified number 
of bytes* Validation cf PVA's is now performed* 

change.mejBory <base> <value> <change.count> 

Default parameter valuess 

<change_coynt>5 1 

6*3.11 RUN 



The purpose of this subcommand is to invoke program 
execution after a selected p interrupt has occurred* 

run 



6*3.12 SUPER.CHANGE.HEHORY J SCH 



The purpose of this subcopfl^and Is the same as the change 
luewory subconnnand* that Is* to change the contents of virtual 
memory* It differs from change memoryt however^ in that It 
Mill change the attributes of the segment to allow memory to 
be written* and then change the attributes bacl« to their 
original values* 
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6.D SYSTEH CORE DEBUGGER 
6,3*12^SUP|2.CHAMG£^HEH0RY^^^SCM^^^^^ 

Ttie coiBiiiand format is the sape as the change memory 
subcoffiiaand* 

6, 3*13 FORHAT J FHT 

The purpose of this sybco^niand Is to set the system core 
debugiier Into a siode nhere all subcoiaiwand output Is sent to a 
permanent file* This Is done by having the task running the 
debugner co^aiunlcate with another task running in the system 
job. It Is this other task that actually creates and writes 
the permanent file. The entry point of this task Is 
OSP$8R0KEN^J0B.0OHP.TASK. It will nori^ally be Initiated by 
the DS procedure* If it is not running* a diagnostic will be 
Issued* This task will create successive cycles of the 
permanent file «DUI1P» in the $SYSTEH catalog* These files 
contain ASCII text data written in BAH variable records* The 
paraiaeter to this command Is a string which will be output as 
the first line of the file* 

format string 

6*3*14 UNFORHAT I UHFHT 

The purpose of this subcoP!i?and Is to leave the output mode 
established by the FOR HAT con^roand* Output will again be sent 
to the operator console* At this point the permanent file 
will be flushed to mass storage* 

unf ormat 

6.3*15 OISPIAY^MONITOR. FAULT J OISflF 

The purpose of this subcommand Is to display any monitor 
faults present in this task* See the section titled *NOS/VE 
Processing of Job Hode Software Errors' for more inf or JBat I on* 

All monitor fault buffers are displayed in the hope they 

will show some task history* If a given fault buffer is 

invalid the message ••following fault Is not present** Is 
displ ayed* 

displ ay_monitor«.f aul t 
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6.0 SYSTEH CORE DEBUGGER 
6,3«16 OISPIAY.XCB I 0ISXC8 

6.3a6 0ISPLAY.KC8 I OISXCB 

The purpose of this subcosB^and Is to display all of the 
fields of the current task's U.e** the task running the 
debugger) execution control block. 

6.3.17 OISPLAY.TASK^ENVIRCNfieHT I DISTE 

The purpose of this subcoiPiuand is to display the XC8 of all 
tasks running within t^e current job {I.e.j the job with the 
task running the debugger). If the co»!nand Is entered while 
the debugger Is in fornsat j«ode# then a full XC8 Is displayed* 
otherwise Just the tssk nanie* XCB address and global task id 
are displayed. 
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T. iSi£ME-EEQ££Siii£-.0£- JQi-l!IQa£.SQiIM4££«£i£QES 



T.i itiiaai}y£iii3i 



Tasks running in jcb mode will occasionally cause an error 
which Is detected either fey the hardware or ?^OS/VE Jionltor. 
The action taken when an error like this occurs is controlled 
by various system attributes. The purpose of this section Is 
to discuss the types of errors and the effect a given system 
attribute will have upon the handling of the error. 



7*2 IX££S-Q£-.£B£USS 



1) BROKEN TASK: A broken task Is a task in which the trap 
ffiechanlsffi Is not able to function correctly* HOS/VE 
monitor will attempt to repair the trap mechanisfn and send 
a broken task fault to the task* The specific cases of a 
broken task are? 

system error job mode software has 

declared the task to be 
br ok en * (This is a s p ec i a I 
case of broken task*) 

fRonitor fault byffer full job ipode errors are 

occuring but are not being 
processed by job mode. 

traps disabled a job mode error has 

occurred while traps were 
disabled. 

invalid AO the task's AO register was 

Invalid* 

UCR/MCR traps disabled UCR/MCR error occurred with 

traps disabled* 

2) HCR FAULTi This error signifies that job mode caused a 
hardware detected MCR fault* This may be caused by 
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7.0 NOS/VE PROCESSING OF JOB MODE SQFTyARE ERRORS 
7.2 TYPES OF ERRORS 



software or hardware detected yncorr ectabl e error. 

31 UNKNOWN SYSTEH REaUESU This error signifies that job mode 
Issued a sionltor reciuest that Is either Invalid or cannot 
be Issued frow the ring it was issued from* 

4) SESMENT ACCESS FAUITSJ These errors signify that Job mode 
encountered or caused one of the following errorst 

" page fault for an address greater than EQI on a 
read-only file C segment J 

- disk read error 

These errors either originate In NOS/VE monitor or cause 
the hardware to exchange to wonltor. Depending on the values 
of certain system attr Ibutes^ monitor will halt or reflect the 
error back to Job mode as a monitor default. 

It Is at this point that the system core debugger can be 
activated. (See the definition of SYSTEM.DEBUG.RING in the 
next section.) 

The norwal job mode OS actions for these faults are? 

broken task exi t 

MCR fault cause condition 

Invalid syste« request exit 

segment access cause condition 



7. 3 SXH£li.AII£Ifiyi£5l«£0E«£EE0E-£aQC£SSIMfi 



The following systen attributes can be set or displayed by 
the SETSA and DISSA commands. 



7.3.1 HAITRIHG 



If a broken task or HCR fault occurs at or below the value 
of HAITRIHG CP register ring nuiuberl* NOS/VE monitor will halt 
the system. Broken tasks occurring above HAITRIHG will cause 
a monitor fault to be sent back to job mode. 
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T.O NOS/VE PROCESSING OF JOB HOOE SOFTMARE ERRORS 
7,3.2 SYSTeH.£RROf?«HANG«COUHT 

-m-mmt»0m .ttmmmfi mmh* mmt m tmm mmi mimmitmimmMmmt mtmummrm mm mmum mt m mt m m m m »» m im nt *n« m tm S0 m mm M»t mmt mmmm mi mm 

1*%.Z SYSTEM^ERRQR^HAHG^CCtlNT 

This is tlie nuiiiiber of broken task errors atlovied to occur 
In any given task before that task is considered a hung task. 

7.3.3 HALT.ON_HUNG_TASK 

If this attribute Is true# then an occurence of a hung task 
Mill cause HOS/VE iscnltor to halt the syste»i. If the 
attribute Is false* the task hI i I be sent a signal to «hang« 
Itselfj i.e. to go Into ^x\ Infinite i«alt doing nothing. Jobs 
*ilth hung tasks will have a *H In the status field on the 
operator CP display. 

A hung task will also occur if any error happens In job 
ffiode ring 1. 



7.3.4 SrSTEM.DEBUG.RING 



If an error C broken task* HCR fault* unknown system 
re<|yest# or segaient access fault) occurs at or below the value 
of this attribute IP register ring nuwberl* the system core 
debugger will be invoked within the task. At that point in 
tl5?e the task environment can foe examined by using system core 
debugger commands. 

If the RUN conmiand is issued to the debugger* the systen? 
will take Its normal action for the specific fault. 



7.3.5 DUIiP^WHEN^OEBUG 



When the systeai core debugger is invoked by a fault at or 
below SYSTEH_DE8UG.RI^G and the DUMP.WHEN.DEBUG attribute Is 
true* the debugger will automat leal I y create a durop of the 
task (see system core debugger command FORHAT). When the dump 
is complete* normal fault action will take place. The 
following system core debugger commands are executed during an 
automatic dumps 

FORMAT automatic dump data 

TB I 1000 

OISMF 
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rmsm 



7«D NOS/VE PRQCESSINS OF 408 MODE SOFTMARE ERRORS 
7.3.5 OUMP.MHEN.DEBUG 



DISXCB 

m 00300000000 100C0C16I 

on 00400000000 100C0<lfe) 

9H 00500000000 100COC16} 

OH 00600000000 100 CO C 16) 

DM OOFOOOOOOOO 100C0C16) 

DH 01000000000 10OC0CI&) 

on 01100000000 100C0<16I 

DISTE 

UNFORMAT 
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8.0 iIMa.4LQMI-M4llSI4EI 



A staodalons dead start tape Is a 9-track* unlabeled* I 

format* 1600 8PI def^sity tape (produced by the NVESYS 

procedure). To deadstart In standalone mode* perforn? ttie 
fol low I ng steps? 

1) Set the deadstart panel for standard disk deadstart* 

Z) Perform an alternate deadstart to the NVE deadstart tape 
using CTI* The CTI parameters on the •?• display should 
be set as fol I ows 
1 = 

C = <•€• parameter of the SETVE pr ocedur€> 
« <*D' parameter of the SETVE procedure 
« Y wher display Is true 
== H when no display> 
|pll4 « <'CH« parameter of the SETVE procedure> 

3) The tape should move and eventually the message 
"PROCEED*" ^111 appear on the lower left on the console* 

4) Enter CR* Mx#8R«OC0OO0OOOO0O0OOG (Editor's notes 16 
zeros 1 1 

where Mk Is HI for SI 
M2 for S2 
H3 for S3 

This clears the teflfiory bounds register which is set by th 
deadstart* 

5) Enter DR»P2 This displays the CPU registers* The SIT 
should be changlrg; If not* give up* 

6) At this point the system core is loaded and can be 
patched* The ccmmands to display and change fBemory are 
documented In IPMDOC* 

7) To start the system enter SS The CPU registers should 
splnj if they ever stop the CPU has halted. 

8) Enter DD to display the system dayf I le on the right 
screen* 
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91 Enter HV€ deadstart cojinands nhen the system re?iyests 
them* MO « Y* i^ust be specified on the •?* display for 
this to happen* ) 

Notes Standalone deadstart Is always a 'quick* 
deadstartf so no recovery of permanent files Is 
possible* *QUICKOS* «ods is set Internally and need not 
be specified* 

10) Enter DJ to display the systeia Job dayflle when the 
system requests It* The »DJ* display is on the left 
screen* 

11) Now the system is operational and coeroands can be 
entered* 
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9.0 INTERACTIVE ?m4BCJ DUf^P ANALYSIS PROCEDURES 



9 • IliI£ii£IIM£«£EOi££l-iyM£. AH iimi-££Q££aiiE£^ 



The following procedures were developed by the Interactive 
project to assist them In Interpreting duf»ps« They guarantee 
the procedures work If your user name is IFPl otherwise caveat 
emptor • For wore Info relation about these procedyres» contact 
Fred 8ischk€» 



The following dump analysis procedures ^re available in the 
IFP cat a log J 



9.1 



EOOSIH 

This Is a CCL procedure which brings an EDD dump tape on a 
sped f I ed 

VSN into the simulator. The procedure can be accessed from 
the IFP 

catalog as f ol lows: 

get»eddsi!ii/un«ifp 

begi n>*eddsl m#vsn ( vsn is the vsn of the EDD dump tape ) 

9.2 

AMALEXC 



This is a Slwulatcr INCIUOE file which does a preliminary 
analysis of 

the current slwulatcr exchange package < when the systeai 
crashes in task 
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9.2 



services* this wM I normally be JPS )• A qr exc-sion or qr 
exc^raia can be 

used to get Into arother exchange package before doing the 
inc lude. 

The Include file is ANAl£XC/UN«IFP. It can be called frora 
the simulator 

as f oi iOMst 



•getf analexc/un=l f p ' | include analexc 



(carriage return) a lone carriage return must be entered 
after an IHCIUOE 

in order to start it up 



9.3 



SEGDUHP 



This Is a CCL procedure which calls OSOIV to dump a 
specified segment to 
a list file which can then be examined with an editor or 
pr inted. 

The procedure can fee accessed from within the Sl^nulator as 
fol lowsi 



•get*segdump/un= I f p • | « begi n>>segdump#seg> I €n# f i I e> exc* cpf » <* 

The segdurap parameters are? 
seg - segment number in hex i default Is 1 ) 
length - number of bytes to dump In hex ( default Is 10000 ) 
list - name of the list file C default Is LIST ) 
exc - reference exchange package ( default is 4?S ) 
cpf - name of checkpoint file C default is CPF ) 
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9.0 IHTERACTIVE PROJECT DUHI> ANALYSIS PROCEDURES 
9.3 



In most cases of task services debygging# only the seg 
par ameter i s 



needed. 



9.4 



ANALJQB 

This is a CCL procecure *«hich yses OSDIV^ XEOIT and the 
SiJBulator to 

perform an analysis of ail tasks In a specified job. The 
procedure can 

be accessed froi!? n I thin the simulator as follows 5 
»get*anal Job/un»l f p • j » begins *ana I job#seg^cpf • 

The anal job parameters ares 

seg - the monitor segment which contains the exchange 
packages of the job ( 14 Is the system job* 15 Is job 1 etc. 
) C default Is 14 ) 

cpf - the name of the simulator file i default Is CPF ) 

After the procedure has completed* a list of the RHA's of 
the 

job's exchange packages can be obtained by doing the 
fol lowing: 

Include tplist 

(carr I age return) 



A traceback of all tasks In the job can be obtained by 
doing the 
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9.D IHTER ACTIVE PROJECT DUHP ANALYSIS PROCEDURES 
9,4 



fol loMlng: 



Inclycie tbilst 



<carriage return) 



Include tbrun 



(carriage return) 
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1«0 Hardware Overview 

1»1 An Introduction to CYBER 180 

1*2 C18C Instant 

1«3 Hodel Indaperdent General Design Specification - 
ARH1700 

2*0 NOS Reference Hanusis 

2*1 XEDIT V3.0 - 6045 57 30 

2.2 XAF VI. User's Gyi de - 604 55260 

2.3 NOS Version 2 Reference Set ~ Vol 3, 60459680 - Vol 
4, 60459690 

2.4 NOS Systems Progr asimer »s Instant - 60459370 

2.5 HOS Version 2 Opera tor/ Anal yst Handbook - 60459310 

2.6 NOS Version 2 Diagnostic Index - 60459390 

2.7 NOS A170 ERS 

2.8 HOS A170 GID - ARH3060 
3*0 ^QS/VE Reference Dccuaents 

3.1 Program Interface ERS - ARH3610 - obtained fron? 
Karen Rubey <482-3966) or via SES.TOOLDOC 

3.2 Coiniuand Interface ERS - ARH3609 - obtained from 
Karen Rubey C482-3966) or v la SES .TOOIDOC 

3.3 NOS/VE Procedures and Conventions • SESDOIO 
obtained by SES. TOOIDOC 

3.4 Listing of all HOS/VE Modules - obtained by 
SES#DEV1.LISTNV£. See Integration Procedures 
Notebook for details. 

3.5 NOS/VE Internal Interface Maintenance Procedures 
Memo available from S.C* Wood. 

3.6 Integration Procedures Notebook Obtained by: 
Acqulre»IPHOCC/UN»D£Vl. SES.PRINT> IPNDQC. 
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4«0 Tools Reference Docyaents 

4.1 CY8II Interactive Oefeygger - ARH3142 

4.2 SeS User's Stilde - ARH1833 

4.3 CY8II Specification - ARH2298 

4.4 €180 Assembler ERS - ARH1693 

4.5 Simulator ERS - ARH1729 

4.6 VEGEH ERS - ARH2591 

4.7 VELINK ERS - ARH2816 

4.6 Simulated I/C ERS - ARH3125 

4.9 Object Code Utilities ERS - ARH2922 

4.10 CYBIL iBspleiaentat ion Dependent Handbook - ARH3078 

4.11 CYBER 180 If^TERACTIVE DEBUG External Reference 
Specification and Users Guide - S4028 

4.12 CYBER 180 II Assembler ERS - ARH3945 

4.13 ERS for Source Code Utility - ARH3883 
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01,0 IfXEQllill 



Keypolnts are used to give an execution time trace of 
prograas flow by showing that a given function is being perfornsed 
I that ls> that a given procedure Is being executed! « 
Keypolnts may also be used to display request parawetersf 
status and error condltlors* 



Dl • 1 IiSUlli£-ii£I£ailiIS«£Ei:i!>£tiIi.£;QS£ 

The general forin of the keypoint instruction IsJ 
fiNLINE C*keypoint»* ke ypo Jn t^cl ass# oskSin ♦ data^ keypoint. Id)5 

01.1*1 KEYPOINT CLASSES 



A keypoint Is Identified by both ciassf and identifier. 
The fol foxing deck explains the partitioning of the keypoint 
c I asses* 

OSDKEYS 
COMMON 

CONST 

C Keypoint Classes s 

i The 16 keypoint classes supported by the hardware are 

C partitioned between the System^ Product Set and User as follows* 

OS k$ systemic lass « C •• 5 ># 

osk$prodyct.set_cl ass * 6 C 6 •• 10 >> 

oskSuser^c lass * 11 C 11 «• 14 >» 
oskSpflfif. control « 15; 
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Dl,l,l KEYPOIHT CLASSES 

mt m *n>0 m I* -M m *» «*«r M«r »»*»»**» mm »»m mm Mimm mmt mmm mm mm mmmmmmmm m m mt* m m mmmtmmmmmmmmmmmmmmtmm 

i Keypoint Hultipilers 

C 

C By convention* 

C the 32 bit keypoint code supported by the hardware 

C Is split into two fields. The right field contains a keypoint 

C Identifier which Is ysed to identify a function within a 

£ keypoint class* For 8xafflple# If a particular keypoint class 

C represents exit from a proceduret 

C then the keypoint Identifier light Identify exit froi« 

C procedure A versus exit froia procedure B« 

C The left field is used as a data parameter appropriate to the 

C function identified by the keypoint Identifier. In the 

C procedure exit exaniple zbo^^^f 

C the data parameter field aight be used to indicate the 

C status of the procedure call* 

C The keypoint multiplier Is used to partition the keypoint 

C code into the two fields. The data parameter should be 

C fflultlpried by the keypoint luultlpner to prevent It froji? 

C overlapping the keypoint identifier field. 

CONST 

oskSffl * 40 96 J 



01.1.2 NQS/VE KEYPOINT CLASSES 



Five keypoint classes n^m^^ ENTRY* EXIT* UNUSUAL* DEBUG* 
and DATA are defined* taking five of the available sixteen classes 
by the hardware. 

ENTRY - Every gated procedure plus all major internal procedures 
(those shared across functional areas) should contain a 
keypoint of this class. These keypolnts should be placed 
as close as possible to the entry to the procedure. 

EXIT - Every gated procedure plus all major internal procedures 
(those shared accross functional areas) should contain a 
keypoint of this class. These keypolnts should be placed 
as closed as possible to the exit to the procedure. 

UNUSUAL - Every situation which is unexpected or quite unusual 
should contain a keypoint of this class. It Is Intended 
that these keypolnts would be enabled at all times. The 
frequency of encountering these keypolnts SHOULD BE 
very low. The DATA keypoint class is not allowed in 
conjunction with a keypoint of class unusual. 
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DEBUS - Thase keypolnts are for providing additional trace 

infomsatlon as an assist In debugging tiardware or so ft *i are 
pr obi ems* DEBUG class key points woyid be raost useful in 
tlie more coippIeK areas of the systera* 

DATA - This keypoint class can be used «lth ENTRY* EXIT* and 
0E8UG keypoints for the gathering of extra data* All DATA 
keypoints encountered are supplying additional data which 
villi foe associated with the last ENTRY* EXIT* or DEBUG 
keypoint* 

DATA keypoints should be used i«iith care since the 9Hf 
hardware can only buffer up 16 keypoints* keypoint cluster 
can cause lost keypoints* 

The following deck defines the NQS/VE OS class constants* 

OSOKEYC 

COHHQH 

CDeflne KEYPOINT CLASS Codes. 

CONST 

oskldata » oskSsystem^class 4-0* C OS - DATA keypoint> 
oskSunusual « oskSsys tem„c lass + 1* CU OS - Unusual keypoint*! 
oskSentry « osk$systei!i_class + 2* IE OS - Entry keypoint)> 
oskSexIt = oskSsysteiB. class ♦ 3* CX OS - Exit keypoint> 
oskSdebug « oskSsystep^class + 4* CD OS - Debug keypoint*> 

C*cal I c* osdkeys 



Dl*l*3 KEYPOINT DATA AND IDENTIFICATION 

Upon successful execution each keypoint instrucion will 
provide a total of 32 bits of Information* Our convention uses 
12 bits of this for keypoint Identification and the regaining 20 
bits as user supplied data* Try to use this 20 bits to supply 
meaningful Inforffliation (taskid* segiient number* file Identifier* 
queue length* page number* tisne* etc*)* The keypoint 
Identification codes are ceflned In the attached coaiiuon deck* On 
DATA class keypoints the data belongs to the previous keypoint 
and the full 32 bits is available for additional user data* 



Cycle 9* October 1982 



01-4 
NOS/VE BACKGROUND DOCUHENTS 

dUO KEYPOIHTS 

01.1.4 gXAMPLE ISSUING KEYPOINTS 



01.1.4 EXAMPLE ISSUING KEYPOIMTS 



ENTRY keypoint with datas 

#IMLIME< •keypoJnt'* oskSentrvf osk$i*taskld. Index/ 
tfflkSexi t^task) J 



UNUSUAL keypoint with no datas 

#INLINE C»keypoint»* oskSunusual^ 0> m mk$no ^memory ) i 

ENTRY keypoint with extra data? 

#INLINE («keypolnt»f osk$entry# oskSm ♦ segment. nyisber* 

fflfiskSpage.f aul t )$ 
#INLINE C«keypolnt«# osk#data» offsets 0)| 

01.1.5 KEYPOIHT IDEHTIFIERS 



Each area of the operating system has been given a range of 
Identifiers to use for keypoints. The base for each area Is 
defined on coimuon deck OSDKEYO. Each area should 
have a deck xxOKEY (where xx Is the product identifier) 
where the areas keypoint constants are def InedCe.g.tnikSexl t^task). 
Please reference the section on keypoint description decks* for an 
exaiijple of one of these decks. 

OSDKEYD 

CQHHON 

CThls deck defines constants for use with KEYPOIHTS. 



CDeflne base keypoint procedure Identifiers for each area of the 
COS. 

CONST 

aiakSbase » 100# ClOO - 1491 

bakSbase = 200, C200 - 2491 

clkSbase ^ 250, C250 - 2991 

cmkSbase = 300, CSOO - 3491 

dbkSbase - 350^ C350 - 399> 

dnikSbase « 400, C400 - 5491 

fmkSbase « 550, C550 - 599> 
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ickSbase « 600^ C600 - 649> 

IfkSbase « 650> C650 - 699> 

iikSbase * 700j C700 - 749> 

inkSbase « 750* C750 - 799> 

jiiikSbase « 800» C800 - 849> 

IgkSbase * 850, £850 « 899> 

MkSbase * 9C0# £900 - 949> 

lokSbase « 950, C950 - 999> 

lukSbase = 1000# CIGOC - 10491 

ifilklbase « 1050, C105C - 1099} 

maikSmoni tor. base » IICO, CllOG - 1149> 

Wfl5k$Job_base « 115D, C1150 - 1199> 

BiskSbase « 1200, C120€ - 1249> 

mtkSbase « 1250, C125C - 1299> 

ocklbase * 1300, C130C - 13491 

ofkSbase = 1350, C135C - 13991 

oskSbase « 1400, C140C - 14491 

pfkSbase « 1500, C150C - 15491 

prakSbase = 1600, C160C - 16991 

rbk$base = 1750, C175C - 17991 

srkSbase » 1800, €1800 - 18191 

stkSbase « 1850, C185C - 18991 

tmkSflioni tor. base « 19C0, C190G - 19491 

tfflkSjob.base « 1950, (1950 - 19991 

jskSwoni tor. base « 2OC0, C2000 - 20491 

jsk$job.base « 205D, {2050 - 20991 

avkSbase * 2100, C210C - 21491 

sfkSbase « 2150, €215C - 21991 

iokSbase « 2200, C220C - 22491 

rmkSbase = 2250, C225C - 23001 

flitk$asserably_language«base * 4000J C4000 - 40951 
C OS assembly language 4000 - 40951 

C*cal I c, osdkeyc 



01.2 QQLL£aiI!i£-.ii£lEQil^IS 



Dl.2.1 ON THE SIHUIATOR 

When executing on the simulator all keypoint Instructions cause 

an entry to be added to the local file SESSHKF. 
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Dl.2.2 OH THE HARDWARE 



Software keypoint collection is available for collecting system 
and job keypolnts. Systeii^ keypoints are those keypoints in the 
entire systea? and job keypoints are only those dealing with a 
particular job. Only one system keypoint collector 
can be active at one tlf«e# but each job way have an active 
job keypoint collector. Software keypoints are collected on a 
file local to the job In which the keypoint collection task is 
running. After keypoint collection Is terminated this file can 
saved on the 170 side and analyzed by the keypoint analyzer. 

Three commands are supplied to utilize the keypoint features 
ACTK# DEAKf and EHIK. 

Dl • 2 . 2 a A£IK-fifiliaQi3 

The ACTK comaiand initiates keypoint recording and collecting. 
It has the form ofs 



ACTK# «aode»env ir onment^ »onitor_fnask» job^aiask^ 
startle! ass# stop^c I 8ss»keypo in t„f i I e# 
CO I I ector_byf f er.s I ze^co \ \ ector^de I sy 

mode or ffl = 'software'* 's'* parameter is 

' hardware •# or *h« required 

environwent or e » 'Job'^'J'* parameter Is 

♦system'* or *s' required 

mon it or. flask or mm ^ a list of Integers default is ali 

ranging froai to 15 
example: mm* ( 2>6»9>12) 

Job^jnask or jis = a list of Integers default is all 

ranging from to 15 

e X asnp I e J jm= < C> 3* 5 ) 

start.ciass or start = an Integer In default Is 15 

the range froni to 15 

This specifies that keypoint collection 
should not start until a keypoint of this 
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class Is encoyfitered. 

stop.ctass or stop - an integer in defaylt Is 15 

the range from to 15 

This specifies that keypoint collection 
should stop when a keypoint of this 
class Is encountered* 

keypolnt.f I le or kf * file name default Is 

This specifies the file on uhlch SlQCAL.KEYFItE 

key points are to be saved* 

This parameter Is used 

only with software keypolnts* 

col lector^buf f er^size or cbs - an Integer default Is 10»000 

In the range f ro^ 100 to 100^000 

This parameter Is used only with 

software keypoints* 
col lector _del ay or cd « an Integer default Is 50 

in the range from 10 to 100*000 

The value specified Is the delay 

period In isl I I iseconds* This 

parameter Is used only with 

software keypoints* 



Dl .2.2.2 0£4!i-£fiJBiaQii 

The DEAK cojuwand terminates keypoint collection. 

0£AK#environiBent 

environment or e « *Job»^'J'# default Is job 

• systeaiV* or ^ s» 

01.2.2.3 EilIil.iIfiilJQi2 

The EMIK cownsand Is ysed to issue keypoints* 

Ef1IK»c I ass^code 

class « an Integer In the range default Is 15 

frojB to 15 

code = an integer In the range default Is 
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01,0 KEYPOINTS 



t0-0»i»mi»m*»mMMi¥rmi*mMmr-mMm*rMm4mMi»/<**0-Mm4>»»tmiMMMm»0*-MM*»MmtMMM4»i>rM4>»mMmmt»»mM 



from to OFFFFFFFF(165 



After keypoint collect I en Is terflilnatsd the keypoint flle» 
can be saved on the 170 by a REPIACE^FILE with B56 
conversion. For example* 

I^EPIACE.F It£# keyf i i e# k ey f II e* b56 

On the 170 side this can be analyzed by using NVEKEY* 
format * HDW. 



01 . 3 !l£I£QiiI^MAL12£S«yi JLIII 



Dl.3.1 NVEKEY 



The SESSHKF file produced on the simulator* or the 
KEYFILE produced on the hardware can be reformatted Into a 
readable listing by executing the following procedure. 

SES.MVEKEY CKPF^ 1 CFORHAT* 3 £KD« 3 CAREA* 3 

HVEKEY creates a simulator generated keypoint trace file. 

The ••kpf'* parameter Is the keypoint file used as Input* 

The '•kd*' parameter is a file or list of files which deflneCs) 

the keypoint descriptions* 

——PARAMETER -DEFAULT ALLOWABLE VALUES 

kpf «SESSmF« file name 

'KEYFILE* if format«HOM 

format «SIH» slm*hdw 

kd •KEYDESC* file name<s) 

area €USER6 user name 



If run Inter acti vely# wher the procedure terminates the 
reformatted listing is on local file KEYFILE* 
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Dl.3.2 KEYPOINT DESCRIPTION FILE 



The keypoint dsscrlpt i ons are used by ttie keypoint 
aiialyzer utility to direct the reforwattlT^g of the 
keypoint information. 



Di.3.2.1 li&XEfllni^dafilsa 



Each area has a keypoint constant deck xxOKEY (jihere xx 
Is the product Id). The keypoint descriptions are now 
inclyded In this deck I niiuedl ate! y foil oiling the keypoint 
constants (sIpHlar to the niessage tempi ates). 

Each description has the fol losing format. 

Notes each element Clf given) Is positional ly dependant. 

CCIASS CSUB^ID.FIEIDI KEYPOIHT.tASEl CDATA.IABE13 IDATA^FIELDI 

CLASS of keypoint ~ required 
E Entry 
X exit 
U Unusual 
D Debug 

SU8_ID_FIELD - optional - (described later) 

KEYPOIMT.LABEL - required - This Is a string that 
describes the purpose of the keypoint. 

OATA.LABEL - optional - This is a string of up to 8 

characters describing the data portion of the keypoint* 

DATA.FIELD.DESCRIPTOR - optional - This consists of data 
format and length, 
data. format 

H Hex 

I Integer { decima I ) 

A ASCII 
Concatenated to this Is the length of the data portion of 
the keypoint* In declffal bits. 
For example* 120 
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D1.3,2a.l EXAHPLE KEYPQINT DECK 

STDKEY 
COMHON 

C PURPOSES 

C This deck contains all of tlie set manager keypoint constants* 

CONST 

stktcreate^set « stkSbase -*• 1# 

€E «stp$create_set » 'ring • H > 

CX •stpScreate^set • 'status • 120 > 

s tkSpurge.set « stkSfease + 2» 
CE •stpSpyrge^set • > 
CX 'stpSpurge^set* 'status • 120 > 

stk$cant^dfl!«.store^set.or<l « stk$base# 

CU 'cant dsjpSstOf e_avt.se t. Of dina I « 'avtlndx • H20 > 

stkSpf.root.sIze « stkSbase + 5| 

£0 •pf.root^slze' «rootslz • H20 > 

?? PUSH (LIST J« OFF) ?t 
{;*cal I c osdkeyd 
?? POP ?? 



Dl,3.2a.2 SUa.IO.FIElD 

This optional field at I cms a means of subdividing a single 
keypoint Into several descriptors. The particular descriptor 
is chosen on the basis of a selectable number of bits of the 
data field. This field has the following formats 

SUS.IO.LENGTH.SUB.ID.f^ATCH 

SJB^IO^IENGTH - This specifies the number of bits Cright i!?ost) 
of the data field to use* to determine which 
descriptor to choose. 

SU8_I0_MATCH - This specifies the Integer Identifier used to 
fsatch the data portion. 

Examp les 

mnikSp age. fault « mrnkSincnl tor.base + 6# 
CE 'page fault processor* > 

CE 4.1 'Page found in avail queue* 'pfti • H16} 

CE 4.2 *Page found In avail modified queue • 'pfti « H16> 
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cnus xne *i«x» ror examples 

#IN11XNE C«l<eypoint«# oskSentry* osk$i» * 

(pfti * 16 IZ ** sub.ld. length! ♦ 2Csut>.i d^pat 

fflfik$page_f aul t) J 



ch>) 



Dl • 3.2 .2 aSQ££ltiaa«il2S«ilM££iEtfi£-.f lis 



The keypoint descrlpticns are kept on a file called KEYOESC 
Q<n the Integration catalog* This file way be produced hyJ 

SES.6ENC0HP M«OSHKEYS A8«C (HQSVEPi*OStP I* INT2) ) CF*KEYD£$C 

The user may add keypolnts to her xxOKEY deck locallyf and 
the KEYDESC file ?iiay be produced as above* specifying the 
additional local bases. The KEYDESC file may then be saved 
on her catalog. 

If new keypoint decks are added* *callc «s to these new decks 
chould be added to the deck QSMKEYS* and the appropriate 
base constants added to deck OSDKEYO. 

idhen transmitting changes to keypoint decks* be sure to inform 
Integration* via the transittal form* to recreate the file 
KEYDESC. 



01 . 3. 2 .3 asiEfixs«ifl£iai 



This section viiif only be useful to those desiring to add 
additional keypoint classes* keypoint class base constants* 
or new keypoint description decks* 

The classes* Identifiers* and descriptions are each buffered 
by a cowment* For exainple* to add another keypoint class: 
C$$S START KEYPOINT CLASSES $$$> 
CONST 

pskSentry « oskSproduct.set.cl ass + 1; CE PS - entry keypoint! 
C$S$ END KEYPOINT CLASSES $$$ > 
notex The E follwoing the "C** Mill be used in the description. 
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This ne« section should be appei^ded to the end of the KEYOESC 
file. Readers desiring jnere inforwatlon should reference the 
attached BNFi and the attached decks OSMKEYS» 



The foil oiling represents 
the description aioduie* 
Notes CoiBiaent put around 



a sample of how to set up 

♦ call for sake of docui»entatlon only* 



CISHKEYS 

?? LEFT J« 1# RIGHT s« IIC ?? 

HQOULE keypolnt^descript I cn.f I le; 

C*cal I Cf osdkeys 

C$$$ START KEYPQINT CLASSES $$$> 

{!*cal I c»osdkeyc 

C$S$ EHO KEYPOINT CLASSES $$$> 

C$$$ START KEYPOINT IDENTIFIER BASES $$$> 

C*cal I Cfosdkeyd 

C$$$ EHO KEYPOINT IDENTIFIER BASES $S$> 

C$$$ START KEYPOINT DESCRIPTIONS $$$> 

C*cal I cp awdkey 

C'^cal I Cfbadkey 

C*can ocl dkey 

C*cal I Cf CBidkey 

C*cal I cp dbdkey 

C*cal I c* dffidkey 

C*cal I c* f ^dkey 

C*cal I c# Icdkey 

C*cal 1 c# if dkey 

C*cal i c# i I dkey 

C*cal Icf Indkey 

C^cal I Qp jmdkey 

C*cal I c> Igdkey 

C*cal I c> 1 1 dkey 

C*cal I Cf I odkey 

C^cal i C9 ludkey 

C*cai I c# mi dkey 

C*cal I OBnndfflkey 

^♦cai I Cf maidjkey 

C*cal I c»msdkey 

€*can c# flit dkey 

C*cai I Cf ocdkey 

^♦cai I Cf of dkey 

C*cal I Cf osdkey 

C*cal I Cf pf dkey 

C*cal I Cfprodkey 

C*cal I Cf rhdkey 

C*cal I Cf sr dkey 

C*cal I Cf stdkey 

C*cal I Cf tmdrokey 
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C*cal Ic* tfidjkey 

C*cal i Cf jsdmkey 

C*cal lc» JsdJKey 

C*caM c#av«ikey 

C*cal I c» sf dkey 

C*cal I Cf lodkey 

£*cal I c#r«3dkey 

C$$$ END KEYPOINT OESCP.IPIIQHS $$$> 

MOOEMD keypolnt^descrlpt I cn.f I le j 



01 . 4 S££aEll4II£12-EIL£.a£^£EI£IIQB 



The output from procedure NVEKEY Is a file called KEYFILE. 
This reforwatted listing cor^talns t**o sections. The first 
section Is a listing of all the keypolnts in the order they were 
issued* The second section is a sumfliary of the nuiRber of times 
each keypoint occured* 

Each line In the first section has the following formati 

RT TSL DATA DATA^LABEL S TN AREA.ID KP^LABEl 

The RT field designates the value of the free running 
microsecond clock (time since deadstart) when the keypoint was 
executed. On the simulator the clock is incremented by 1 for 
each instruction executed. 

The TSL field designates the ti^e <ir Icroseconds) since the 
last keypoint Instruction was executed. 

The DATA field specifies the value of the data portion of the 
keypoint In the format described in the keypoint description 
file for this keypoint. 

The OATA.tABEt field I s the data label field from the 
keypoint description file for this keypoint. 
This Identifies the data being displayed. 

The S field specifies the state of the machine when the 
keypoint was issued and is one of the following: 

M - Hon I tor mode 
J - Job mode 

An * preceding the S field Indicates that 

trap processing is active^ that is the trap handler has 
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been entered^ but not exited. 

The TN fi«ld gives the global task Id of the task that 
^ms executing mhen the keypolnt was Issued* 
The system is task !• 

The AREA.ID field Is the area identifier for the area 
issuing the keypoint* 

The KP^lABEl is the keypoint label field from the keypoint 
description file. This describes the keypoint* 



MOTES For an undefined keypoint* that is* onQ which has no 
descriptor entry* the area. id field contains the 
integer for the keypoint classf the class field 
on the output is specified as "UND»*# and the KP.LABEl 
becomes the id. number of the keypoint* 



01 . 5 aM£.ll£X£QiliI«a£SaEi£IIflf^ 

<analyzer.descr I ptor.lnput> 25 « <keypo Int.cl as s.al I oca 1 1 on.deck> 

C <def in itlon.deck> ••• 1 

<keypo Int.cl ass.al locat I on..deck> Js* <cybM code and/or corofl?ents> 

I <cl ass.base.def inl t ions> ••• 3 
<cybi I code and/or conBments> 

<c I ass^base.def Inl tlons> ss« <ci ass.base.l d> <spc> * <spc> <foase> 

<c I ass_base.ld> s:= oskSsystem.c lass • oskSproduct.set.c lass ' 

oskSuser.class • oskSpmf.control 

<spc> 25= C <space> •«• 3 

<base> 2 5« <integer> 

<def inition.deck> 52* <c I «ss. def In i t Ion. deck> J 

<base.def i nl t ion.deck> 5 
<keypoint.def I nl tl on.deck> 

<class.def inition.deck> s 5= i%$% START KEYPOINT CLASSES $$$> 

<cybH code and/or coraisents> 
I <c lass.def init lons> •*• 3 
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<cybll code and/or coiiiJients> 
C$$$ END KEYPOINT ClASSES $$$> 

<ci ass^def ini tions> ss» <l«eypoin t_cl ass> <spc> « <spc> 

<class_base«ld> <offset> 
C <keypo In t^cl ass_id> <cybil co»5Bient> 

<keypo int_c! ass> ??« <ldentlfler> 

<offset> si« 4- <spc> <int€g€r> <delinilter> 

<delimiter> s:« $ \ % 

<keypo lnt_cl ass_ld> ss- <character> 

<base.d8f I nl tIon_deck> ??» 

C$$ START KEYPOINT lOEHTIFIER BASES $$$> 
<cybi I code and/or com!aents> 
C <range^base_def Ir^ I tlons> ••« 3 
<cybi I code and/or comii!ents> 
C$$$ END KEYPOINT IDENTIFIER BASES $$$> 

<r tnge^base.def i ni tl ons> 8s« <keypoi nt_base> <deliffllter> 

<base^r ange> 

<keypo lnt«base> s?« <spc> <base_id> <spc> « <spc> <base> 

<base.ld> 55* <identifi8f> 

<base_range> 5Sa <spc> C <low.base> <sp> - <fiigh«base> C > 1 

<low^base> S5* < Integer > 

<hlgh.base> 5 5s <integer> 

<keypo Int.def Inl tlon_deck> 5s« 

{$$$ START KEYPOINT DESCRIPTIONS $$$> 
<cybll code and/or co(JHRents> 
C <xxdkey_deck> ••• 1 
<cybil code and or coffl«ents> 
C$$$ END KEYPOINT DESCRIPTIONS $$$> 

<xxdkey.deck> ss« c <cybM code and/or coin«3ents> 3 

t <keypolnt.lnfo> ••• 3 

<keypo lnt«lnfo> 25* <keypoint. constant. I lne> <dellmlter> <eoI> 

C <keypolnt«descr lptor> ••• 3 
C <b lank I lnes> 3 
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<keypo int^constarit^l lne> s:« <k€ypolnt.constant> <spc> « <spc> 

<keypol nt«base> <spc> £ <offs8t> J <spc> 

<keypolfit«constant> t?« <ld€ntifler> 

<keypo int.base> ss« <idsntifler> 

<keypo int_descrlptor> SJ* C <keypo int.descri ptor^l I st> <spc> C > 3 

<eol> 

<k8ypo Int. descriptor. I is t> J 2* <keypol nt.class.l d> <spc> 

C <specl al.case.cod€> 3 <spc> 
C <$ub.i d.f I et d> 3 <spc> <keypoi nt.l abe l> 
<spc> I <data.fj«ld> 3 

<specl al.case.code> ss« M * N * $ • T 

(H « Htr> N » Nos» S * task S*iitch> and T = Trap) 

<sub.i d.f i el d> s:« <sub.l d.l ength> • <syb_id.iwatch> 

<sub.l d.lengtli> Js= <f I el c.length> 

<f leld.length> si= 0..52 (in bits) 

<sub.i d.iatch> J s« <sfflal l.lnteger> 

<sraall.integer> a^ 0..0 FFFFFFFFFFFFF (16) 

<keypolnt.labei> ss« <lab€l> 

<label> js« « <character.strlng> » 

<character.str ing> ?:» any visible characters except ' 

<data.field> :s* <data.label> <spc> C <dat a.f I el d.descr I ptor> 3 

<data.label> ss« <label> 

<data.f I eld.descr lptor> it- <dat a.f ormat> I <data.f i el d.length> 3 

<data«format> 8J« A J H J I 

(A » Alphanumeric^ H = Hex* I = Integer) 

<data.fleld.length> s:« <f leld.l ength> 

CMOTEs <syb.ld.length> ♦ <data.f le I d.l ength> fnust be <= 52 bits ) 
(NOTE: operating system <keypoin t.cl ass.ld> * COfE»U>X>) 
(NOTE? <keypolnt.cl ass.l d> for any keypoint used for 
additional Information to previous keypolnts 
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must be a space) 

(NOTES a <def i ni tion_deck> regains In effect until 

superceeded by a deck which redefines the 

area to which it pertains) 
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